Paketflash.display
Klassepublic class LoaderInfo
VererbungLoaderInfo Inheritance EventDispatcher Inheritance Object

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die LoaderInfo-Klasse liefert Informationen zu einer geladenen SWF- oder Grafikdatei (JPEG, GIF oder PNG). LoaderInfo-Objekte sind für jedes Anzeigeobjekt verfügbar. Die bereitgestellten Informationen sind Ladefortschritt, die URLs des Loaders und des geladenen Inhalts, Gesamtanzahl der Bytes für das Medium und die nominelle Höhe und Breite des Mediums.

Sie haben zwei Möglichkeiten, LoaderInfo-Objekte zu laden:

Die contentLoaderInfo-Eigenschaft eines Loader-Objekts liefert Informationen zum Inhalt, der vom Loader-Objekt geladen wird, während die loaderInfo-Eigenschaft eines Anzeigeobjekts Informationen zur SWF-Stammdatei für dieses Anzeigeobjekt liefert.

Die loaderInfo-Eigenschaft eines mit einem Loader-Objekt geladenen Objekts (eine SWF- oder Bitmap-Datei) verweist auf dasselbe LoaderInfo-Objekt wie die contentLoaderInfo-Eigenschaft des Loader-Objekts. Anders ausgedrückt: Sowohl die geladene Objektdatei als auch das Loader-Objekt, das sie geladen hat, verwenden dasselbe LoaderInfo-Objekt. Da die Instanz der Hauptklasse der SWF-Datei kein Loader-Objekt besitzt, besteht ihre einzige Möglichkeit, auf das LoaderInfo-Objekt zuzugreifen, in der loaderInfo-Eigenschaft.

Das folgende Diagramm zeigt die verschiedenen Einsatzmöglichkeiten des LoaderInfo-Objekts, und zwar für die Instanz der Hauptklasse der SWF-Datei, für die contentLoaderInfo-Eigenschaft eines Loader-Objekts und für die loaderInfo-Eigenschaft eines geladenen Objekts:

Ist ein Ladevorgang noch nicht abgeschlossen, sind einige Eigenschaften der contentLoaderInfo-Eigenschaft eines Loader-Objekts nicht verfügbar. Einige Eigenschaften können Sie abrufen, z. B. bytesLoaded, bytesTotal, url, loaderURL und applicationDomain. Sobald das loaderInfo-Objekt das Ereignis init auslöst, können Sie auf alle Eigenschaften des loaderInfo-Objekts sowie der geladenen Grafik- oder SWF-Datei zugreifen.

Hinweis: Alle Eigenschaften der LoaderInfo-Objekte sind schreibgeschützt.

Die EventDispatcher.dispatchEvent()-Methode gilt nicht für LoaderInfo-Objekte. Wenn Sie dispatchEvent() für ein LoaderInfo-Objekt aufrufen, wird eine IllegalOperationError-Ausnahme ausgelöst.

Beispiele anzeigen

Siehe auch

flash.display.Loader
flash.display.Loader.content
flash.display.DisplayObject
flash.display.DisplayObject.loaderInfo
Überwachen des Ladevorgangs


Öffentliche Eigenschaften
 EigenschaftDefiniert von
  actionScriptVersion : uint
[read-only] Die ActionScript-Version der geladenen SWF-Datei.
LoaderInfo
  applicationDomain : ApplicationDomain
[read-only] Wenn eine externe SWF-Datei geladen wird, werden alle in der geladenen Klasse enthaltenen ActionScript 3.0-Definitionen in der applicationDomain-Eigenschaft gespeichert.
LoaderInfo
  bytes : ByteArray
[read-only] Die einem LoaderInfo-Objekt zugeordneten Bytes.
LoaderInfo
  bytesLoaded : uint
[read-only] Die Anzahl der für das Medium geladenen Bytes.
LoaderInfo
  bytesTotal : uint
[read-only] Die Anzahl der komprimierten Bytes in der gesamten Mediendatei.
LoaderInfo
  childAllowsParent : Boolean
[read-only] Drückt die Vertrauensbeziehung von Inhalt (untergeordnetes Objekt) zu Loader (übergeordnetes Objekt) aus.
LoaderInfo
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
  content : DisplayObject
[read-only] Das diesem LoaderInfo-Objekt zugeordnete geladene Objekt.
LoaderInfo
  contentType : String
[read-only] Der MIME-Typ der geladenen Datei.
LoaderInfo
  frameRate : Number
[read-only] Die nominelle Bildrate der geladenen SWF-Datei, in Bildern pro Sekunde.
LoaderInfo
  height : int
[read-only] Die nominelle Höhe der geladenen Datei.
LoaderInfo
  loader : Loader
[read-only] Das diesem LoaderInfo-Objekt zugeordnete Loader-Objekt.
LoaderInfo
  loaderURL : String
[read-only] Die URL der SWF-Datei, die das Laden des von diesem LoaderInfo-Objekt beschriebenen Mediums initiiert hat.
LoaderInfo
  parameters : Object
[read-only] Ein Objekt, das Name/Wert-Paare enthält, die die Parameter der geladenen SWF-Datei repräsentieren.
LoaderInfo
  parentAllowsChild : Boolean
[read-only] Drückt die Vertrauensbeziehung von Loader (übergeordnetes Objekt) zu Inhalt (untergeordnetes Objekt) aus.
LoaderInfo
 Inheritedprototype : Object
[static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.
Object
  sameDomain : Boolean
[read-only] Drückt die Domänenbeziehung zwischen dem Loader und dem Inhalt aus: "true", wenn beide aus derselben Domäne stammen, sonst "false".
LoaderInfo
  sharedEvents : EventDispatcher
[read-only] Eine EventDispatcher-Instanz, die zum Austauschen von Ereignissen über mehrere Sicherheitsgrenzen hinweg verwendet werden kann.
LoaderInfo
  swfVersion : uint
[read-only] Die Dateiformatversion der geladenen SWF-Datei.
LoaderInfo
  url : String
[read-only] Die URL des Mediums, das gerade geladen wird.
LoaderInfo
  width : int
[read-only] Die nominelle Breite des geladenen Inhalts.
LoaderInfo
Öffentliche Methoden
 MethodeDefiniert von
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.
EventDispatcher
 Inherited
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
  
[static] Gibt das LoaderInfo-Objekt zurück, das mit einer als Objekt definierten SWF-Datei verknüpft ist.
LoaderInfo
 Inherited
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Gibt das angegebene Objekt als String zurück.
Object
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner vorangegangenen Elementen ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.
EventDispatcher
Ereignisse
 EreignisÜbersicht Definiert von
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
   Wird nach dem erfolgreichen Laden von Daten ausgelöst.LoaderInfo
 Inherited Wird ausgelöst, wenn Flash Player den Betriebssystemfokus verliert und inaktiv wird.EventDispatcher
   Wird ausgelöst, wenn per HTTP eine Netzwerkanforderung eingereicht wurde und Flash Player den HTTP-Statuscode ermitteln kann.LoaderInfo
   Wird ausgelöst, wenn die Eigenschaften und Methoden einer geladenen SWF-Datei zugänglich sind.LoaderInfo
   Wird beim Auftreten eines Eingabe- oder Ausgabefehlers ausgelöst, durch den der Ladevorgang fehlschlägt.LoaderInfo
   Wird beim Start eines Ladevorgangs ausgelöst.LoaderInfo
   Wird ausgelöst, wenn während des Download-Vorgangs Daten empfangen werden.LoaderInfo
   Wird von einem LoaderInfo-Objekt ausgelöst, wenn ein geladenes Objekt mit der unload()-Methode des Loader-Objekts entfernt wird oder wenn von demselben Loader-Objekt ein zweiter Ladevorgang durchgeführt und der ursprüngliche Inhalt vor dem Ladebeginn entfernt wird.LoaderInfo
Eigenschaftsdetail
actionScriptVersionEigenschaft
actionScriptVersion:uint  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die ActionScript-Version der geladenen SWF-Datei. Die Sprachversion wird anhand der Zusammenfassung in der ActionScriptVersion-Klasse angegeben, z. B. ActionScriptVersion.ACTIONSCRIPT2 und ActionScriptVersion.ACTIONSCRIPT3.

Hinweis: Diese Eigenschaft besitzt immer entweder den Wert ActionScriptVersion.ACTIONSCRIPT2 oder ActionScriptVersion.ACTIONSCRIPT3. ActionScript 1.0 und 2.0 fallen beide unter den Wert ActionScriptVersion.ACTIONSCRIPT2 (Version 2.0). Diese Eigenschaft unterscheidet nur zwischen ActionScript 1.0/2.0 und ActionScript 3.0.


Implementierung
    public function get actionScriptVersion():uint

Auslöser
Error — Wenn der heruntergeladene Anteil der Datei nicht ausreicht, um die angeforderten Informationen abzurufen.
 
Error — Wenn die Datei keine SWF-Datei ist.

Siehe auch

applicationDomainEigenschaft 
applicationDomain:ApplicationDomain  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wenn eine externe SWF-Datei geladen wird, werden alle in der geladenen Klasse gespeicherten ActionScript 3.0-Definitionen in der Eigenschaft applicationDomain gespeichert.

Der gesamte Code in einer SWF-Datei ist so definiert, dass er sich in einer Anwendungsdomäne befindet. Die aktuelle Anwendungsdomäne ist die Domäne, in der die Hauptanwendung ausgeführt wird. Die Systemdomäne enthält alle Anwendungsdomänen, einschließlich der aktuellen Domäne, d. h. alle Klassen von Flash Player.

Mit Ausnahme der Systemdomäne sind alle Anwendungsdomänen mit einer übergeordneten Domäne verknüpft. Die Systemdomäne ist die übergeordnete Domäne der applicationDomain-Eigenschaft der Hauptanwendung. Geladene Klassen werden nur definiert, wenn sie in der jeweils übergeordneten Klasse nicht bereits definiert sind. Die Definition einer geladenen Klasse kann nicht mit einer neueren Definition überschrieben werden.

Beispiele für die Verwendung von Anwendungsdomänen finden Sie im Handbuch Programmieren mit ActionScript 3.0 im Kapitel "Clientsystem-Umgebung".


Implementierung
    public function get applicationDomain():ApplicationDomain

Auslöser
SecurityError — Dieser Sicherheits-Sandbox des Aufrufers ist es nicht gestattet, auf diese Anwendungsdomäne zuzugreifen.

Siehe auch

bytesEigenschaft 
bytes:ByteArray  [read-only]

Sprachversion : ActionScript 3.0

Die einem LoaderInfo-Objekt zugeordneten Bytes.


Implementierung
    public function get bytes():ByteArray

Auslöser
SecurityError — Wenn dem Objekt, das auf diese API zugreift, der Zugriff auf das geladene Objekt aufgrund von Sicherheitsbeschränkungen verweigert wird. Dies kann beispielsweise geschehen, wenn ein Loader-Objekt auf die contentLoaderInfo.content-Eigenschaft zugreifen möchte und ihm die Sicherheitsberechtigung für den Zugriff auf den geladenen Inhalt nicht erteilt wird.

Weitere Informationen finden Sie im Kapitel "Sicherheitsaspekte im Flash Player" des Handbuchs Programmieren mit ActionScript 3.0.

Player Version: Flash Player 9 Update 3.

bytesLoadedEigenschaft 
bytesLoaded:uint  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Anzahl der für das Medium geladenen Bytes. Wenn diese Zahl mit dem Wert von bytesTotal identisch ist, ist das Medium vollständig geladen.


Implementierung
    public function get bytesLoaded():uint
bytesTotalEigenschaft 
bytesTotal:uint  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Anzahl der komprimierten Bytes in der gesamten Mediendatei.

Bevor das erste progress-Ereignis von dem entsprechenden Loader-Objekt dieses LoaderInfo-Objekts ausgelöst wird, hat bytesTotal den Wert 0. Nach dem ersten progress-Ereignis des Loader-Objekts entspricht bytesTotal der tatsächlich herunterzuladenden Anzahl von Bytes.


Implementierung
    public function get bytesTotal():uint

Siehe auch

childAllowsParentEigenschaft 
childAllowsParent:Boolean  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Drückt die Vertrauensbeziehung von Inhalt (untergeordnetes Objekt) zu Loader (übergeordnetes Objekt) aus. Hat das untergeordnete Objekt den Zugriff durch das übergeordnete Objekt erlaubt, gilt true, sonst gilt false. Diese Eigenschaft wird auf true gesetzt, wenn das untergeordnete Objekt die allowDomain()-Methode aufgerufen hat, um eine Berechtigung für die übergeordnete Domäne zu erteilen, oder wenn von der untergeordneten Domäne eine domänenübergreifende Richtlinie geladen wird, die die Berechtigung für die übergeordnete Domäne erteilt. Befinden sich das untergeordnete und das übergeordnete Objekt in derselben Domäne, wird diese Eigenschaft auf true gesetzt.

Weitere Informationen finden Sie im Kapitel "Sicherheitsaspekte im Flash Player" des Handbuchs Programmieren mit ActionScript 3.0.


Implementierung
    public function get childAllowsParent():Boolean

Auslöser
Error — Wird ausgelöst, wenn der geladene Anteil der Datei nicht ausreicht, um die angeforderten Informationen abzurufen.
contentEigenschaft 
content:DisplayObject  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Das diesem LoaderInfo-Objekt zugeordnete geladene Objekt.


Implementierung
    public function get content():DisplayObject

Auslöser
SecurityError — Wenn dem Objekt, das auf diese API zugreift, der Zugriff auf das geladene Objekt aufgrund von Sicherheitsbeschränkungen verweigert wird. Dies kann beispielsweise geschehen, wenn ein Loader-Objekt auf die contentLoaderInfo.content-Eigenschaft zugreifen möchte und ihm die Sicherheitsberechtigung für den Zugriff auf den geladenen Inhalt nicht erteilt wird.

Weitere Informationen finden Sie im Kapitel "Sicherheitsaspekte im Flash Player" des Handbuchs Programmieren mit ActionScript 3.0.

contentTypeEigenschaft 
contentType:String  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Der MIME-Typ der geladenen Datei. Der Wert ist null, wenn der geladene Anteil der Datei nicht ausreicht, um den Typ zu bestimmen. In der folgenden Liste sind die möglichen Werte enthalten:


Implementierung
    public function get contentType():String
frameRateEigenschaft 
frameRate:Number  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die nominelle Bildrate der geladenen SWF-Datei, in Bildern pro Sekunde. Diese Zahl ist häufig eine Ganzzahl, was aber nicht zwingend notwendig ist.

Dieser Wert kann von der tatsächlich verwendeten Bildrate abweichen. Flash Player verwendet zu einem bestimmten Zeitpunkt immer nur eine einzige Bildrate für alle geladenen SWF-Dateien. Dies ist die Bildrate, die von der nominellen Bildrate der Haupt-SWF-Datei bestimmt wird. Es ist auch möglich, dass Flash Player aufgrund von Hardware-Einschränkungen, der Sound-Synchronisierung oder anderen Faktoren nicht in der Lage ist, die Hauptbildrate zu erreichen.


Implementierung
    public function get frameRate():Number

Auslöser
Error — Wenn der heruntergeladene Anteil der Datei nicht ausreicht, um die angeforderten Informationen abzurufen.
 
Error — Wenn die Datei keine SWF-Datei ist.
heightEigenschaft 
height:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die nominelle Höhe der geladenen Datei. Dieser Wert kann von der tatsächlichen Höhe abweichen, in der der Inhalt angezeigt wird, da der geladene Inhalt oder seine übergeordneten Anzeigeobjekte auch skaliert sein können.


Implementierung
    public function get height():int

Auslöser
Error — Wenn der heruntergeladene Anteil der Datei nicht ausreicht, um die angeforderten Informationen abzurufen.
loaderEigenschaft 
loader:Loader  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Das diesem LoaderInfo-Objekt zugeordnete Loader-Objekt. Wenn es sich bei diesem LoaderInfo-Objekt um die loaderInfo-Eigenschaft der Instanz der SWF-Datei-Hauptklasse handelt, wird kein Loader-Objekt zugeordnet.


Implementierung
    public function get loader():Loader

Auslöser
SecurityError — Wenn dem Objekt, das auf diese API zugreift, der Zugriff auf das Loader-Objekt aufgrund von Sicherheitseinschränkungen verweigert wird. Dies kann beispielsweise geschehen, wenn eine geladene SWF-Datei auf seine loaderInfo.loader-Eigenschaft zugreifen möchte und ihr die Sicherheitsberechtigung für den Zugriff auf die ladende SWF-Datei nicht erteilt wird.

Weitere Informationen finden Sie im Kapitel "Sicherheitsaspekte im Flash Player" des Handbuchs Programmieren mit ActionScript 3.0.

loaderURLEigenschaft 
loaderURL:String  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die URL der SWF-Datei, die das Laden des von diesem LoaderInfo-Objekt beschriebenen Mediums initiiert hat. Für die Instanz der Hauptklasse der SWF-Datei entspricht diese URL der URL der SWF-Datei selbst.


Implementierung
    public function get loaderURL():String
parametersEigenschaft 
parameters:Object  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Ein Objekt, das Name/Wert-Paare enthält, die die Parameter der geladenen SWF-Datei repräsentieren.

Sie können eine for-in-Schleife verwenden, um alle Namen und Werte aus dem parameters-Objekt zu extrahieren.

Die beiden Quellen für die Parameter sind: der Abfragestring in der URL der Haupt-SWF-Datei und der Wert des FlashVars-HTML-Parameters (dies betrifft nur die Haupt-SWF-Datei).

Die parameters-Eigenschaft ersetzt das in ActionScript 1.0 und 2.0 verwendete Verfahren, bei dem SWF-Dateiparameter als Eigenschaften der Hauptzeitleiste bereitgestellt wurden.

Der Wert der Eigenschaft parameters ist null für Loader-Objekte, die SWF-Dateien enthalten, die ActionScript 1.0 oder 2.0 verwenden. Der Wert ist nur für solche Loader-Objekte ungleich null, die SWF-Dateien enthalten, die ActionScript 3.0 verwenden.


Implementierung
    public function get parameters():Object
parentAllowsChildEigenschaft 
parentAllowsChild:Boolean  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Drückt die Vertrauensbeziehung von Loader (übergeordnetes Objekt) zu Inhalt (untergeordnetes Objekt) aus. Hat das übergeordnete Objekt den Zugriff durch das untergeordnete Objekt erlaubt, gilt true, sonst gilt false. Diese Eigenschaft wird auf true gesetzt, wenn das übergeordnete Objekt die allowDomain()-Methode aufgerufen hat, um eine Berechtigung für die untergeordnete Domäne zu erteilen, oder wenn von der übergeordneten Domäne eine domänenübergreifende Richtlinie geladen wird, die die Berechtigung für die untergeordnete Domäne erteilt. Befinden sich das untergeordnete und das übergeordnete Objekt in derselben Domäne, wird diese Eigenschaft auf true gesetzt.

Weitere Informationen finden Sie im Kapitel "Sicherheitsaspekte im Flash Player" des Handbuchs Programmieren mit ActionScript 3.0.


Implementierung
    public function get parentAllowsChild():Boolean

Auslöser
Error — Wird ausgelöst, wenn der geladene Anteil der Datei nicht ausreicht, um die angeforderten Informationen abzurufen.
sameDomainEigenschaft 
sameDomain:Boolean  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Drückt die Domänenbeziehung zwischen dem Loader und dem Inhalt aus: true, wenn beide aus derselben Domäne stammen, sonst false.


Implementierung
    public function get sameDomain():Boolean

Auslöser
Error — Wird ausgelöst, wenn der geladene Anteil der Datei nicht ausreicht, um die angeforderten Informationen abzurufen.
sharedEventsEigenschaft 
sharedEvents:EventDispatcher  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Eine EventDispatcher-Instanz, die zum Austauschen von Ereignissen über mehrere Sicherheitsgrenzen hinweg verwendet werden kann. Selbst wenn Loader und geladener Inhalt nicht über ein gegenseitiges Vertrauensverhältnis verfügen, können beide auf "sharedEvents" zugreifen.


Implementierung
    public function get sharedEvents():EventDispatcher
swfVersionEigenschaft 
swfVersion:uint  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die Dateiformatversion der geladenen SWF-Datei. Das Dateiformat wird anhand der Zusammenfassung in der SWFVersion-Klasse angegeben, z. B. SWFVersion.FLASH7 und SWFVersion.FLASH9.


Implementierung
    public function get swfVersion():uint

Auslöser
Error — Wenn der heruntergeladene Anteil der Datei nicht ausreicht, um die angeforderten Informationen abzurufen.
 
Error — Wenn die Datei keine SWF-Datei ist.

Siehe auch

urlEigenschaft 
url:String  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die URL des Mediums, das gerade geladen wird.

Bevor das erste progress-Ereignis von dem entsprechenden Loader-Objekt des LoaderInfo-Objekts ausgelöst wird, kann es sein, dass der Wert der url-Eigenschaft nur die ursprünglich in der load()-Methode des Loader-Objekts angegebene URL widerspiegelt. Nach dem ersten progress-Ereignis spiegelt die url-Eigenschaft die endgültige URL des Mediums wider, nachdem etwaige Weiterleitungen und relative URLs aufgelöst wurden.


Implementierung
    public function get url():String

Siehe auch

widthEigenschaft 
width:int  [read-only]

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Die nominelle Breite des geladenen Inhalts. Dieser Wert kann von der tatsächlichen Breite abweichen, in der der Inhalt angezeigt wird, da der geladene Inhalt oder seine übergeordneten Anzeigeobjekte auch skaliert sein können.


Implementierung
    public function get width():int

Auslöser
Error — Wenn der heruntergeladene Anteil der Datei nicht ausreicht, um die angeforderten Informationen abzurufen.
Methodendetail
getLoaderInfoByDefinition()Methode
public static function getLoaderInfoByDefinition(object:Object):LoaderInfo

Sprachversion : ActionScript 3.0

Gibt das LoaderInfo-Objekt zurück, das mit einer als Objekt definierten SWF-Datei verknüpft ist.

Player Version: Flash Player 9 Update 3.

Parameter

object:Object — Ein SWF-Dateiobjekt.

Rückgabewerte
LoaderInfo — Das zugeordnete LoaderInfo-Objekt.
Ereignisdetail
complete Ereignis
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.COMPLETE

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird nach dem erfolgreichen Laden von Daten ausgelöst. Das Ereignis complete wird immer nach dem Ereignis init ausgelöst.

Definiert den Wert der Eigenschaft type eines complete-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Netzwerkobjekt, dessen Ladevorgang beendet ist.

Siehe auch

httpStatus Ereignis  
Ereignisobjekttyp: flash.events.HTTPStatusEvent
HTTPStatusEvent.type property = flash.events.HTTPStatusEvent.HTTP_STATUS

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, wenn per HTTP eine Netzwerkanforderung eingereicht wurde und Flash Player den HTTP-Statuscode ermitteln kann.

Definiert den Wert der Eigenschaft type eines httpStatus-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
statusDer vom Server zurückgegebene HTTP-Statuscode.
targetDas Netzwerkobjekt, das den HTTP-Statuscode empfängt.

Siehe auch

init Ereignis  
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.INIT

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, wenn die Eigenschaften und Methoden einer geladenen SWF-Datei zugänglich sind. Ein LoaderInfo-Objekt löst das init-Ereignis aus, wenn die folgenden beiden Bedingungen erfüllt sind:

Das Ereignis init wird immer vor dem Ereignis complete ausgelöst.

Definiert den Wert der Eigenschaft type eines init-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas LoaderInfo-Objekt, das mit der zu ladenden SWF-Datei verknüpft ist.

Siehe auch

ioError Ereignis  
Ereignisobjekttyp: flash.events.IOErrorEvent
IOErrorEvent.type property = flash.events.IOErrorEvent.IO_ERROR

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird beim Auftreten eines Eingabe- oder Ausgabefehlers ausgelöst, durch den der Ladevorgang fehlschlägt.

Definiert den Wert der Eigenschaft type eines ioError-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Netzwerkobjekt, bei dem der Eingabe/Ausgabe-Fehler auftritt.
textDer als Fehlermeldung anzuzeigende Text.

Siehe auch

open Ereignis  
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.OPEN

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird beim Start eines Ladevorgangs ausgelöst.

Definiert den Wert der Eigenschaft type eines open-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Netzwerkobjekt, über das eine Verbindung geöffnet wurde.

Siehe auch

progress Ereignis  
Ereignisobjekttyp: flash.events.ProgressEvent
ProgressEvent.type property = flash.events.ProgressEvent.PROGRESS

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird ausgelöst, wenn während des Download-Vorgangs Daten empfangen werden.

Definiert den Wert der Eigenschaft type eines progress-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
bytesLoadedDie Anzahl der geladenen Elemente oder Byte zu dem Zeitpunkt, zu dem der Listener das Ereignis verarbeitet.
bytesTotalDie Gesamtanzahl der Elemente oder Byte, die bei einem erfolgreichen Ladevorgang schließlich geladen werden.
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDer Protokollierungsstatus des Netzwerkobjekts.

Siehe auch

unload Ereignis  
Ereignisobjekttyp: flash.events.Event
Event.type property = flash.events.Event.UNLOAD

Sprachversion : ActionScript 3.0
Player-Version : Flash Player 9

Wird von einem LoaderInfo-Objekt ausgelöst, wenn ein geladenes Objekt mit der unload()-Methode des Loader-Objekts entfernt wird oder wenn von demselben Loader-Objekt ein zweiter Ladevorgang durchgeführt und der ursprüngliche Inhalt vor dem Ladebeginn entfernt wird.

Definiert den Wert der Eigenschaft type eines unload-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden Eigenschaften:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas LoaderInfo-Objekt, das mit der zu entfernenden oder zu ersetzenden SWF-Datei verknüpft ist.

Siehe auch

Beispiele Verwendung von Beispielen
LoaderInfoExample.as

Im folgenden Beispiel wird die LoaderInfoExample-Klasse verwendet, um auf der Bühne ein Bild anzuzeigen. Dies wird in den folgenden Schritten erreicht:
  1. Es wird eine url-Eigenschaft erstellt, die den Speicherort und Namen der Bilddatei angibt.
  2. Der Klassenkonstruktor erstellt ein Loader-Objekt mit der Bezeichnung loader.
  3. Das loader-Objekt instanziiert einen Ereignis-Listener, um sicherzustellen, dass das Bild richtig geladen wird.
  4. Der Konstruktor erstellt eine neue Instanz eines URLRequest-Objekts, request, mit Übergabe von url, damit der Dateiname und -speicherort bekannt sind.
  5. Das request-Objekt wird an die load()-Methode des loader-Objekts übergeben, die das Bild in die Anzeigeliste lädt.

Wichtig: Zur Ausführung dieses Beispiels müssen Sie eine Datei mit dem Namen "Image.gif" in dem Verzeichnis ablegen, in dem sich auch die kompilierte SWF-Datei befindet. Verwenden Sie ein Bild mit einem Bereich, der in die Abmessungen der SWF-Hauptdatei passt.

package {
    import flash.display.Loader;
    import flash.display.LoaderInfo;
    import flash.display.Sprite;
    import flash.events.*;
    import flash.net.URLRequest;

    public class LoaderInfoExample extends Sprite {
        private var url:String = "Image.gif";

        public function LoaderInfoExample() {
            var loader:Loader = new Loader();
            loader.contentLoaderInfo.addEventListener(Event.INIT, initHandler);
            loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
            var request:URLRequest = new URLRequest(url);
            loader.load(request);
            addChild(loader);
        }

        private function initHandler(event:Event):void {
            var loader:Loader = Loader(event.target.loader);
            var info:LoaderInfo = LoaderInfo(loader.contentLoaderInfo);
            trace("initHandler: loaderURL=" + info.loaderURL + " url=" + info.url);
        }

        private function ioErrorHandler(event:IOErrorEvent):void {
            trace("ioErrorHandler: " + event);
        }
    }
}




 

Eine E-Mail an mich senden, wenn dieser Seite Kommentare hinzugefügt werden | Kommentarbericht

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/flash/display/LoaderInfo.html