| Paket | fl.display |
| Klasse | public class ProLoader |
| Vererbung | ProLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Hinweis: ProLoader ist keine Unterklasse von flash.display.Loader. Um ProLoader zu verwenden, müssen Sie alle Verweise auf Loader zu ProLoader ändern.
ProLoader bietet ein konstantes Ladeerlebnis. Dies ist besonders hilfreich bei SWF-Dateien, die RSL-Vorausladen verwenden. SWF-Dateien mit TLF-Text verwenden zum Beispiel standardmäßig RSL-Vorausladen. In diesem Fall verzögert ProLoaderInfo das Senden der INIT- oder COMPLETE-Ereignisse, bis das RSL-Vorausladen abgeschlossen ist und echter Inhalt verfügbar ist. Im Ergebnis kann die content-Eigenschaft dann auf echten Inhalt zugreifen. ProLoader trägt auch zur Vermeidung anderer Probleme bei, zum Beispiel:
- Zusätzliche
addedToStage- undremovedFromStage-Ereignisse - Inhalt, der in das falsche übergeordnete Element in Bild 1 geladen wird (gilt für Inhalt, der mit Flash Professional CS5.5 für Flash Player 10.2 oder höher veröffentlicht wird).
Warnung: Bestimmte ProLoader-Mitglieder unterstützten nicht alle Versionen der Laufzeitumgebung. Greifen Sie nur dann auf diese Mitglieder zu, wenn sie von Ihrer veröffentlichten AIR- oder Flash Player-Version unterstützt werden. Andernfalls geben diese APIs Laufzeitfehler aus. Zu den Mitgliedern mit eingeschränkter Unterstützung für Laufzeitumgebungen gehören die folgenden Methoden und Eigenschaften:
-
unloadAndStop() -
loadFilePromise() -
uncaughtErrorEvents
Welche Laufzeitumgebungen jeweils unterstützt werden, finden Sie in den Referenzabschnitten zu den einzelnen APIs.
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | accessibilityImplementation : AccessibilityImplementation
Die aktuelle Eingabehilfenimplementierung (AccessibilityImplementation) für diese InteractiveObject-Instanz. | InteractiveObject | |
| accessibilityProperties : AccessibilityProperties
Die aktuellen Optionen für Eingabehilfen zur Barrierefreiheit dieses Anzeigeobjekts. | DisplayObject | |
| alpha : Number
Gibt den Alphatransparenzwert des angegebenen Objekts an. | DisplayObject | |
| blendMode : String
Ein Wert aus der BlendMode-Klasse, mit dem angegeben wird, welcher Mischmodus verwendet werden soll. | DisplayObject | |
| blendShader : Shader [Nur Schreiben]
Legt einen Shader fest, der für das Mischen von Vordergrund und Hintergrund verwendet wird. | DisplayObject | |
| buttonMode : Boolean
Legt den Schaltflächenmodus für dieses Sprite fest. | Sprite | |
| cacheAsBitmap : Boolean
Wird diese Eigenschaft auf „true“ gesetzt, speichern Flash-Laufzeitumgebungen eine interne Bitmap-Darstellung des Anzeigeobjekts im Cache. | DisplayObject | |
| cacheAsBitmapMatrix : Matrix
Bei einem Nicht-Null-Wert definiert dieses Matrix-Objekt, wie ein Anzeigeobjekt dargestellt wird, wenn cacheAsBitmap auf „true“ gesetzt ist. | DisplayObject | |
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| content : DisplayObject [schreibgeschützt]
Enthält das Stamm-Anzeigeobjekt der SWF- oder Bilddatei (JPG, PNG oder GIF), die mit der load()- oder loadBytes()-Methode geladen wurde. | ProLoader | ||
| contentLoaderInfo : ProLoaderInfo [schreibgeschützt]
Gibt ein ProLoaderInfo-Objekt zurück, das dem Objekt entspricht, das geladen wird. | ProLoader | ||
| contextMenu : NativeMenu
Gibt das diesem Objekt zugeordnete Kontextmenü an. | InteractiveObject | |
| doubleClickEnabled : Boolean
Gibt an, ob das Objekt doubleClick-Ereignisse empfängt. | InteractiveObject | |
| dropTarget : DisplayObject [schreibgeschützt]
Gibt das Anzeigeobjekt an, über das der Sprite gezogen wird oder auf dem der Sprite abgelegt wurde. | Sprite | |
| filters : Array
Ein indiziertes Array, das alle dem Anzeigeobjekt derzeit zugeordneten filter-Objekte enthält. | DisplayObject | |
| focusRect : Object
Gibt an, ob für dieses Objekt ein Fokusrechteck angezeigt wird. | InteractiveObject | |
| graphics : Graphics [schreibgeschützt]
Legt das Graphics-Objekt fest, das zu diesem Sprite gehört und für das Vektorzeichnungsbefehle zulässig sind. | Sprite | |
| height : Number
Gibt die Höhe des Anzeigeobjekts in Pixeln an. | DisplayObject | |
| hitArea : Sprite
Gibt als Kollisionsbereich für ein Sprite ein anderes Sprite an. | Sprite | |
| loaderInfo : LoaderInfo [schreibgeschützt]
Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört. | DisplayObject | |
| mask : DisplayObject
Das aufrufende Anzeigeobjekt wird durch das angegebene mask-Objekt maskiert. | DisplayObject | |
| metaData : Object
Bezieht das Metadatenobjekt der DisplayObject-Instanz, wenn Metadaten neben der Instanz dieses DisplayObject in der SWF-Datei durch ein PlaceObject4-Tag gespeichert wurden. | DisplayObject | |
| mouseChildren : Boolean
Bestimmt, ob die untergeordneten Elemente des Objekts maus- oder benutzereingabegerätfähig sind oder nicht. | DisplayObjectContainer | |
| mouseEnabled : Boolean
Gibt an, ob dieses Objekt Meldungen von der Maus oder einem anderen Benutzereingabegerät empfängt. | InteractiveObject | |
| mouseX : Number [schreibgeschützt]
Gibt die x-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | DisplayObject | |
| mouseY : Number [schreibgeschützt]
Gibt die y-Koordinate der Position der Maus oder des Benutzereingabegeräts in Pixeln an. | DisplayObject | |
| name : String
Gibt den Instanznamen des Anzeigeobjekts an. | DisplayObject | |
| needsSoftKeyboard : Boolean
Gibt an, ob eine virtuelle Tastatur (Bildschirmtastatur) angezeigt wird, wenn diese InteractiveObject-Instanz den Fokus erhält. | InteractiveObject | |
| numChildren : int [schreibgeschützt]
Liefert die Anzahl der Objekte, die diesem Objekt untergeordnet sind. | DisplayObjectContainer | |
| opaqueBackground : Object
Legt fest, ob das Anzeigeobjekt bei einer bestimmten Hintergrundfarbe undurchsichtig ist. | DisplayObject | |
| parent : DisplayObjectContainer [schreibgeschützt]
Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält. | DisplayObject | |
| root : DisplayObject [schreibgeschützt]
Bei einem Anzeigeobjekt in einer geladenen SWF-Datei ist die root-Eigenschaft das oberste Anzeigeobjekt in dem Teil der Baumstruktur der Anzeigeliste, der diese SWF-Datei repräsentiert. | DisplayObject | |
| rotation : Number
Gibt die Drehung der DisplayObject-Instanz ausgehend von der ursprünglichen Ausrichtung in Grad an. | DisplayObject | |
| rotationX : Number
Gibt die x-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. | DisplayObject | |
| rotationY : Number
Gibt die y-Achsendrehung der DisplayObject-Instanz in Grad an, und zwar bezogen auf die ursprüngliche Ausrichtung zum übergeordneten 3D-Container. | DisplayObject | |
| rotationZ : Number
Gibt die Drehung der z-Achse der DisplayObject-Instanz in Grad an, ausgehend von ihrer ursprünglichen Ausrichtung relativ zum übergeordneten 3D-Container. | DisplayObject | |
| scale9Grid : Rectangle
Das aktuell verwendete Skalierungsraster. | DisplayObject | |
| scaleX : Number
Gibt die horizontale Skalierung (Prozentwert) des Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | |
| scaleY : Number
Gibt die vertikale Skalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | |
| scaleZ : Number
Gibt die Tiefenskalierung (Prozentwert) eines Objekts ausgehend vom Registrierungspunkt an. | DisplayObject | |
| scrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt. | DisplayObject | |
| softKeyboard : String
Steuert das Erscheinungsbild der Bildschirmtastatur. | InteractiveObject | |
| softKeyboardInputAreaOfInterest : Rectangle
Definiert einen Bereich, der auf dem Bildschirm sichtbar bleiben soll, wenn eine virtuelle Tastatur angezeigt wird (nicht unter iOS verfügbar). | InteractiveObject | |
| soundTransform : flash.media:SoundTransform
Steuert den Sound innerhalb dieses Sprites. | Sprite | |
| stage : Stage [schreibgeschützt]
Die Bühne des Anzeigeobjekts. | DisplayObject | |
| tabChildren : Boolean
Bestimmt, ob die dem Objekt untergeordneten Objekte per Tabulatortaste aktivierbar sind. | DisplayObjectContainer | |
| tabEnabled : Boolean
Gibt an, ob sich dieses Objekt in der Tabulatorreihenfolge befindet. | InteractiveObject | |
| tabIndex : int
Gibt die Tabulatorreihenfolge von Objekten in einer SWF-Datei an. | InteractiveObject | |
| textSnapshot : flash.text:TextSnapshot [schreibgeschützt]
Liefert ein TextSnapshot-Objekt für diese DisplayObjectContainer-Instanz. | DisplayObjectContainer | |
| transform : flash.geom:Transform
Ein Objekt mit Eigenschaften, die zur Matrix, Farbtransformation und Pixelbegrenzung eines Anzeigeobjekts gehören. | DisplayObject | |
| uncaughtErrorEvents : EventDispatcher [schreibgeschützt]
Ein Objekt, das ein uncaughtError-Ereignis absetzt, wenn ein nicht verarbeiteter Fehler im Code der SWF-Datei dieses ProLoader-Objekts auftritt. | ProLoader | ||
| useHandCursor : Boolean
Ein boolescher Wert, der angibt, ob der Handcursor angezeigt werden soll, wenn der Zeiger über ein Sprite geführt wird, in dem die buttonMode-Eigenschaft auf „true“ gesetzt ist. | Sprite | |
| visible : Boolean
Gibt an, ob das Anzeigeobjekt sichtbar ist oder nicht. | DisplayObject | |
| width : Number
Gibt die Breite des Anzeigeobjekts in Pixeln an. | DisplayObject | |
| x : Number
Gibt die x-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | DisplayObject | |
| y : Number
Gibt die y-Koordinate der DisplayObject-Instanz relativ zu den lokalen Koordinaten des übergeordneten DisplayObjectContainer-Objekts an. | DisplayObject | |
| z : Number
Gibt die z-Koordinatenposition an der z-Achse der DisplayObject-Instanz relativ zum übergeordneten 3D-Container an. | DisplayObject | |
| Methode | Definiert von | ||
|---|---|---|---|
Erstellt ein ProLoader-Objekt, mit dem Sie Dateien laden können, zum Beispiel in den Formaten SWF, JPEG, GIF oder PNG. | ProLoader | ||
|
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. | DisplayObjectContainer | |
|
Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu. | DisplayObjectContainer | |
| 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 | |
|
Gibt an, ob aufgrund der Sicherheitseinschränkungen irgendwelche Anzeigeobjekte aus der Liste ausgeschlossen werden, die beim Aufrufen der DisplayObjectContainer.getObjectsUnderPoint()-Methode mit dem angegebenen point-Punkt zurückgegeben wird. | DisplayObjectContainer | |
Bricht einen aktuell für die ProLoader-Instanz ausgeführten Vorgang der load()-Methode ab. | ProLoader | ||
|
Ermittelt, ob das angegebene Anzeigeobjekt der DisplayObjectContainer-Instanz oder der Instanz selbst untergeordnet ist. | DisplayObjectContainer | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert. | DisplayObject | |
|
Gibt die untergeordnete Anzeigeobjektinstanz zurück, die sich an der angegebenen Indexposition befindet. | DisplayObjectContainer | |
|
Gibt das untergeordnete Anzeigeobjekt für den angegebenen Namen zurück. | DisplayObjectContainer | |
|
Gibt die Indexposition einer untergeordneten DisplayObject-Instanz zurück. | DisplayObjectContainer | |
|
Gibt ein Array an Objekten zurück, die unter dem angegebenen Punkt liegen und dieser DisplayObjectContainer-Instanz untergeordnet sind (auch über mehrere Unterordnungsstufen hinweg). | DisplayObjectContainer | |
|
Gibt ein Rechteck zurück, das die Begrenzung des Anzeigeobjekts (ohne etwaige Striche oder Formen) definiert, und zwar aufgrund des vom Parameter „targetCoordinateSpace“ definierten Koordinatensystems. | DisplayObject | |
|
Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts. | DisplayObject | |
|
Konvertiert einen zweidimensionale Punkt von den (globalen) Bühnenkoordinaten in die dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts. | DisplayObject | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Untersucht den Begrenzungsrahmen des Anzeigeobjekts, um festzustellen, ob er sich mit dem Begrenzungsrahmen des obj-Anzeigeobjekts überschneidet. | DisplayObject | |
|
Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter „x“ und „y“ festgelegten Punkt überdeckt oder schneidet. | DisplayObject | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
Lädt eine Datei im Format SWF, JPEG, progressives JPEG, nicht animiertes GIF oder PNG in ein Objekt, das ein untergeordnetes Element dieses ProLoader-Objekts ist. | ProLoader | ||
Lädt in einem ByteArray-Objekt gespeicherte Binärdaten. | ProLoader | ||
Lädt eine IFilePromise-Instanz über den promise-Parameter. | ProLoader | ||
|
Konvertiert einen dreidimensionalen Punkt der dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts in einen zweidimensionalen Punkt der (globalen) Bühnenkoordinaten. | DisplayObject | |
|
Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten. | DisplayObject | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt die angegebene untergeordnete DisplayObject-Instanz aus der Child-Liste der DisplayObjectContainer-Instanz. | DisplayObjectContainer | |
|
Entfernt ein untergeordnetes Anzeigeobjekt aus der angegebenen Indexposition in der Child-Liste des Anzeigeobjekt-Containers. | DisplayObjectContainer | |
|
Entfernt alle untergeordneten DisplayObject-Instanzen aus der Liste der untergeordneten Elemente der DisplayObjectContainer-Instanz. | DisplayObjectContainer | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Blendet eine virtuelle Tastatur ein. | InteractiveObject | |
|
Ändert die Position eines vorhandenen untergeordneten Objekts im Anzeigeobjekt-Container. | DisplayObjectContainer | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Ermöglicht es Benutzern, das angegebene Sprite mit einer Ziehoperation zu verschieben. | Sprite | |
|
Ermöglicht dem Benutzer das Ziehen des angegebenen Sprites auf einem berührungsempfindlichen Gerät. | Sprite | |
|
Stoppt rekursiv die Ausführung von allen Movieclips, die auf diesem Objekt gerootet sind. | DisplayObjectContainer | |
|
Beendet die startDrag()-Methode. | Sprite | |
|
Beendet die startTouchDrag()-Methode zur Verwendung mit berührungsempfindlichen Geräten. | Sprite | |
|
Kehrt die z-Reihenfolge (von vorne nach hinten) der beiden angegebenen untergeordneten Objekte um. | DisplayObjectContainer | |
|
Kehrt die z-Reihenfolge (von vorne nach hinten) der untergeordneten Objekte an den beiden angegebenen Indexpositionen in der Child-Liste um. | DisplayObjectContainer | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
Entfernt ein untergeordnetes Element dieses ProLoader-Objekts, das mit der load()-Methode geladen wurde. | ProLoader | ||
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
content | Eigenschaft |
content:DisplayObject [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Enthält das Stamm-Anzeigeobjekt der SWF- oder Bilddatei (JPG, PNG oder GIF), die anhand der Methode load() oder loadBytes() geladen worden ist.
Implementierung
public function get content():DisplayObjectAuslöser
SecurityError — Die geladene SWF- oder Bilddatei ist Teil einer Sicherheits-Sandbox, auf die Sie keinen Zugriff haben. Sie können diese Situation für eine geladene SWF-Datei vermeiden, indem Sie die Datei die Security.allowDomain()-Methode aufrufen lassen oder die ladende Datei einen Parameter loaderContext laden lassen (für den die securityDomain-Eigenschaft auf SecurityDomain.currentDomain gesetzt ist), wenn Sie die Methode load() oder loadBytes() aufrufen.
|
contentLoaderInfo | Eigenschaft |
contentLoaderInfo:ProLoaderInfo [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Gibt ein ProLoaderInfo-Objekt zurück, das dem Objekt entspricht, das geladen wird. ProLoaderInfo-Objekte werden sowohl vom ProLoader-Objekt als auch von geladenen Inhaltsobjekten genutzt. Das ProLoaderInfo-Objekt stellt Informationen und Statistiken zum Ladefortschritt der geladenen Datei bereit.
Ereignisse, die sich auf den Ladevorgang beziehen, werden vom ProLoaderInfo-Objekt abgesetzt, auf das von der contentLoaderInfo-Eigenschaft des ProLoader-Objekts verwiesen wird. Die contentLoaderInfo-Eigenschaft wird auf ein gültiges ProLoaderInfo-Objekt gesetzt, noch bevor der Inhalt geladen wird, sodass Sie Ereignis-Listener vor dem Laden hinzufügen können.
Um nicht erfasste Fehler zu erkennen, die in einer geladenen SWF-Datei auftreten, verwenden Sie die ProLoader.uncaughtErrorEvents-Eigenschaft, nicht die ProLoader.contentLoaderInfo.uncaughtErrorEvents-Eigenschaft.
Hinweis: Die contentLoaderInfo-Eigenschaft gibt ein ProLoaderInfo-Objekt zurück. ProLoaderInfo ist keine Unterklasse von LoaderInfo und bietet deshalb nicht den Vorteil eines impliziten Abbilds der Superklasse. Ändern Sie deshalb die Typendeklarationen von LoaderInfo zu ProLoaderInfo.
Implementierung
public function get contentLoaderInfo():ProLoaderInfouncaughtErrorEvents | Eigenschaft |
uncaughtErrorEvents:EventDispatcher [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Laufzeitversionen: | Flash Player 10.1, AIR 2.0 |
Ein Objekt, das ein uncaughtError-Ereignis absetzt, wenn ein nicht verarbeiteter Fehler im Code der SWF-Datei dieses ProLoader-Objekts auftritt. Fehler werden nicht erfasst, wenn sie außerhalb von try..catch-Blöcken ausgegeben werden, oder wenn ein ErrorEvent-Objekt ausgelöst wird, aber keine registrierten Listener vorhanden sind.
Diese Eigenschaft wird erstellt, wenn die mit diesem Objekt verknüpfte SWF-Datei vollständig geladen wurde. Bis dahin hat die uncaughtErrorEvents-Eigenschaft den Wert null. In einem reinen ActionScript-Projekt können Sie während oder nach der Ausführung der Konstruktorfunktion der Hauptklasse der SWF-Datei auf diese Eigenschaft zugreifen.
Der Zugriff auf diese ProLoader-Eigenschaft in einem Player, der sie nicht unterstützt, führt zu einem Fehler. Gibt ein EventDispatcher-Objekt anstelle eines UncaughtErrorEvents-Objekts zurück, um das Generieren von Fehlern in nicht unterstützten Playern zu vermeiden.
Implementierung
public function get uncaughtErrorEvents():EventDispatcherVerwandte API-Elemente
ProLoader | () | Konstruktor |
public function ProLoader()| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Erstellt ein ProLoader-Objekt, mit dem Sie Dateien laden können, zum Beispiel in den Formaten SWF, JPEG, GIF oder PNG. Rufen Sie die load()-Methode auf, um das Bestandselement als untergeordnetes Element der ProLoader-Instanz zu laden. Sie können das ProLoader-Objekt dann der Anzeigeliste hinzufügen (zum Beispiel mit der addChild()-Methode einer DisplayObjectContainer-Instanz). Das Bestandselement erscheint auf der Bühne, noch während es geladen wird.
Sie können eine ProLoader-Instanz auch „offlist“ verwenden, also ohne sie einem Anzeigeobjektcontainer auf der Anzeigeliste hinzuzufügen. In diesem Modus kann die Loader-Instanz zum Laden einer SWF-Datei verwendet werden, die zusätzliche Module einer Anwendung enthält.
Um zu erkennen, wann die SWF-Datei vollständig geladen wurde, können Sie die Ereignisse des ProLoaderInfo-Objekts verwenden, die der contentLoaderInfo-Eigenschaft des ProLoader-Objekts zugeordnet sind. An diesem Punkt kann der Code in der Modul-SWF-Datei ausgeführt werden, um das Modul zu initialisieren und zu starten. Im Offlist-Modus kann eine ProLoader-Instanz auch verwendet werden, um eine SWF-Datei zu laden, die Komponenten oder Medienbestände enthält. Auch hier können Sie die Ereignisbenachrichtigungen des ProLoaderInfo-Objekts verwenden, um zu erkennen, wann die Komponenten fertig geladen wurden. An diesem Punkt kann die Anwendung beginnen, mit den Komponenten und Medienbeständen in der Bibliothek der SWF-Datei zu arbeiten, indem die ActionScript 3.0-Klassen, die diese Komponenten und Medienbestände repräsentieren, instanziiert werden.
Um den Status eines ProLoader-Objekts zu bestimmen, überwachen Sie die folgenden Ereignisse, die das ProLoaderInfo-Objekt, das der contentLoaderInfo-Eigenschaft des ProLoader-Objekts zugeordnet ist, absetzt:
- Das
open-Ereignis wird ausgelöst, wenn der Ladevorgang beginnt. - Die Ereignisse
ioErrorbzw.securityErrorwerden ausgelöst, wenn die Datei nicht geladen werden kann oder wenn während des Ladevorgangs ein Fehler aufgetreten ist. - Das
progress-Ereignis wird fortlaufend ausgelöst, während die Datei geladen wird. - Das
complete-Ereignis wird ausgelöst, nachdem eine Datei vollständig heruntergeladen wurde, jedoch noch bevor die Methoden und Eigenschaften des geladenen Movieclips verfügbar sind. Wenn die geladene SWF-Datei RSL-Vorausladen verwendet, wird dieses Ereignis abgesetzt, nachdem das RSL-Vorausladen abgeschlossen wurde. Zu diesem Zeitpunkt ist echter Inhalt in dercontent-Eigenschaft verfügbar. - Das
init-Ereignis wird ausgelöst, sobald die Eigenschaften und Methoden der geladenen SWF-Datei verfügbar sind, sodass Sie mit der Bearbeitung der geladenen SWF-Datei beginnen können. Dieses Ereignis wird vor der Prozedurcompleteausgelöst. In gestreamten SWF-Dateien kann dasinit-Ereignis um einiges früher eintreten als dascomplete-Ereignis. Für die meisten Zwecke ist dieinit-Prozedur geeignet. Wenn die geladene SWF-Datei RSL-Vorausladen verwendet, wird dieses Ereignis abgesetzt, nachdem das RSL-Vorausladen abgeschlossen wurde. Zu diesem Zeitpunkt ist echter Inhalt in dercontent-Eigenschaft verfügbar.
Verwandte API-Elemente
close | () | Methode |
public function close():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Laufzeitversionen: | AIR 1.0, Flash Player Player - 9 |
Bricht einen aktuell für die ProLoader-Instanz ausgeführten Vorgang der load()-Methode ab.
load | () | Methode |
public function load(request:URLRequest, context:LoaderContext = null):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Player Player - 9 |
Lädt eine Datei im Format SWF, JPEG, progressives JPEG, nicht animiertes GIF oder PNG in ein Objekt, das ein untergeordnetes Element dieses ProLoader-Objekts ist. Wenn Sie eine animierte GIF-Datei laden, wird nur das erste Bild angezeigt. Da das ProLoader-Objekt nur ein einziges untergeordnetes Objekt besitzen darf, beendet eine nachfolgende load()-Anforderung eine ggf. noch aktive vorherige Anforderung und beginnt einen neuen Ladevorgang.
Hinweis: In AIR 1.5 und Flash Player 10 ist die maximale Höhe oder Breite eines geladenen Bilds 8.191 Pixel, die Pixelzahl darf insgesamt 16.777.215 nicht übersteigen. (Wenn ein geladenes Bild also 8.191 Pixel breit ist, darf es nur 2.048 Pixel hoch sein.) In Flash Player 9 und niedriger und AIR 1.1 und niedriger liegt die Grenze bei je 2.880 Pixel Höhe und Breite.
Eine SWF- oder Bilddatei, die in ein ProLoader-Objekt geladen wird, übernimmt die Positions-, Drehungs- und Skalierungseigenschaften der übergeordneten Anzeigeobjekte des ProLoader-Objekts.
Mit der unload()-Methode können Sie mit dieser Methode geladene Filme oder Bilder entfernen oder einen laufenden Ladevorgang abbrechen.
Sie können eine SWF-Datei daran hindern, diese Methode aufzurufen, indem Sie auf der HTML-Seite, die den SWF-Inhalt enthält, den Parameter allowNetworking der Tags object und embed festlegen.
Wenn Sie diese Methode verwenden, berücksichtigen Sie das Flash Player-Sicherheitsmodell, das in der ProLoader-Klassenbeschreibung beschrieben wird.
Wenn Sie in Flash Player 10 oder höher einen Multipart-Content-Type verwenden (z. B. „multipart/form-data“), der einen Upload enthält (gekennzeichnet durch einen „filename“-Parameter in einem „content-disposition“-Header innerhalb des POST-Body), so unterliegt die POST-Methode den Sicherheitsregeln für Uploads:
- Der POST-Vorgang muss als Reaktion auf eine durch den Benutzer initiierte Aktion, z. B. Mausklick oder Tastendruck, erfolgen.
- Ist die POST-Methode domänenübergreifend (das POST-Ziel befindet sich auf einem anderen Server als die SWF-Datei, die die POST-Anforderung sendet), so muss der Zielserver eine URL-Richtliniendatei bereitstellen, die den domänenübergreifenden Zugriff erlaubt.
Bei mehrteiligen Inhaltstypen muss zudem auch die Syntax gemäß Standard RFC2046 gültig sein. Scheint die Syntax ungültig zu sein, so unterliegt die POST-Methode den Sicherheitsregeln für Uploads.
Weitere Informationen zum Thema Sicherheit finden Sie im Flash Player Developer Center im Abschnitt Sicherheit.
Parameter
request:URLRequest — Die absolute oder relative URL für die zu ladende SWF-, JPEG-, GIF- oder PNG-Datei. Ein relativer Pfad muss relativ zur Haupt-SWF-Datei angegeben werden. Absolute URLs müssen eine Protokollreferenz wie „http://“ oder „file:///“ enthalten. Dateinamen können keine Laufwerkangaben enthalten.
| |
context:LoaderContext (default = null)
Wenn der Vollständige Angaben finden Sie in der Beschreibung der Eigenschaften in der Klasse LoaderContext. |
Ereignisse
asyncError: — Wird vom contentLoaderInfo-Objekt abgesetzt, wenn die LoaderContext.requestedContentParent-Eigenschaft festgelegt wurde und es nicht möglich ist, den geladenen Inhalt als untergeordnetes Element zum angegebenen DisplayObjectContainer hinzuzufügen. Dazu kann es kommen, wenn der geladene Inhalt ein flash.display.AVM1Movie ist oder wenn der addChild()-Aufruf an requestedContentParent einen Fehler ausgibt.
| |
complete: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn die Datei vollständig geladen ist. Das Ereignis complete wird immer nach dem Ereignis init ausgelöst.
| |
httpStatus: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn eine Netzwerkanfrage über HTTP gestellt wird und Flash Player den HTTP-Statuscode ermittelt hat.
| |
init: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn die Eigenschaften und Methoden der geladenen SWF-Datei zugänglich sind. Das Ereignis init wird immer vor dem Ereignis complete ausgelöst.
| |
ioError: — Wird vom contentLoaderInfo-Objekt beim Auftreten eines Eingabe- oder Ausgabefehlers, durch den der Ladevorgang fehlschlägt, ausgelöst.
| |
open: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn das Laden der Datei beginnt.
| |
progress: — Wird vom contentLoaderInfoObjekt während des Empfangs von Daten im Zuge des Ladevorgangs ausgelöst.
| |
securityError: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn eine SWF-Datei in der
„local-with-filesystem“-Sandbox versucht, Inhalte in der „local-with-networking“-Sandbox zu laden, oder umgekehrt.
| |
securityError: — Wird vom contentLoaderInfo-Objekts abgesetzt, wenn die LoaderContext.requestedContentParent-Eigenschaft festgelegt wurde und die Sicherheitssandbox von LoaderContext.requestedContentParent keinen Zugriff auf die geladene SWF-Datei hat.
| |
unload: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn ein geladenes Objekt entfernt wird.
|
Auslöser
IOError — Die digest-Eigenschaft des request-Objekts ist nicht null. Sie sollten die digest-Eigenschaft eines URLRequest-Objekts nur setzen, wenn Sie beim Laden einer SWZ-Datei (einer Adobe-Plattformkomponente) die URLLoader.load()-Methode aufrufen.
| |
SecurityError — Der Wert von LoaderContext.securityDomain muss entweder null oder SecurityDomain.currentDomain lauten. Dadurch wird die Tatsache widergespiegelt, dass Sie die geladenen Medien nur in deren „natürlicher“ Sicherheits-Sandbox oder in Ihrer eigenen Sandbox platzieren können (wobei die letztere eine Richtliniendatei erfordert).
| |
SecurityError — Lokale SWF-Dateien dürfen „LoaderContext.securityDomain“ auf keinen anderen Wert als null setzen. Es ist nicht zulässig, nicht lokale Medien in eine lokale Sandbox zu importieren oder andere lokale Medien an einem anderen Ort als in ihrer natürlichen Sandbox zu platzieren.
| |
SecurityError — Eine Verbindung mit normalerweise reservierten Ports ist nicht möglich. Eine vollständige Liste der gesperrten Ports finden Sie unter „Beschränken von Netzwerk-APIs“ im ActionScript 3.0 Entwicklerhandbuch.
| |
SecurityError — Wenn die Eigenschaft applicationDomain oder securityDomain des Parameters context aus einer nicht zulässigen Domäne stammt.
| |
SecurityError — Wenn eine lokale SWF-Datei versucht, die securityDomain-Eigenschaft des Parameters context zu verwenden.
| |
IllegalOperationError — Wenn die requestedContentParent-Eigenschaft des context-Parameters ein ProLoader ist.
| |
IllegalOperationError — Wenn der LoaderContext.parameters-Parameter nicht null ist und einige Werte aufweist, die keine Strings sind.
|
Verwandte API-Elemente
loadBytes | () | Methode |
public function loadBytes(bytes:ByteArray, context:LoaderContext = null):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Laufzeitversionen: | Flash Player 9, AIR 1.0, Flash Player 9 |
Lädt in einem ByteArray-Objekt gespeicherte Binärdaten.
Die loadBytes()-Methode ist eine asynchrone Methode. Sie müssen auf das "init"-Ereignis warten, bevor Sie auf die Eigenschaften eines geladenen Objekts zugreifen können.
Wenn Sie diese Methode verwenden, berücksichtigen Sie das Flash Player-Sicherheitsmodell, das in der ProLoader-Klassenbeschreibung beschrieben wird.
Parameter
bytes:ByteArray — Ein ByteArray-Objekt. Der Inhalt des ByteArray-Objekts kann in einem der von der ProLoader-Klasse unterstützten Formate vorliegen: SWF, GIF, JPEG oder PNG.
| |
context:LoaderContext (default = null)applicationDomain-Eigenschaft des LoaderContext-Objekts kann angewendet werden, nicht jedoch die Eigenschaften checkPolicyFile und securityDomain des LoaderContext-Objekts.
Wenn der Weitere Informationen zum Thema Sicherheit finden Sie im Flash Player Developer Center im Abschnitt Sicherheit. |
Ereignisse
asyncError: — Wird vom contentLoaderInfo-Objekt abgesetzt, wenn die LoaderContext.requestedContentParent-Eigenschaft festgelegt wurde und es nicht möglich ist, den geladenen Inhalt als untergeordnetes Element zum angegebenen DisplayObjectContainer hinzuzufügen. Dazu kann es kommen, wenn der geladene Inhalt ein flash.display.AVM1Movie ist oder wenn der addChild()-Aufruf an requestedContentParent einen Fehler ausgibt.
| |
complete: — Wird vom contentLoaderInfo-Objekt abgesetzt, wenn die Operation abgeschlossen ist. Das Ereignis complete wird immer nach dem Ereignis init ausgelöst.
| |
init: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn die Eigenschaften und Methoden der geladenen Daten zugänglich sind. Das Ereignis init wird immer vor dem Ereignis complete ausgelöst.
| |
ioError: — Wird vom contentLoaderInfo-Objekt abgesetzt, wenn die Laufzeitumgebung die Daten in einem Byte-Array nicht analysieren kann.
| |
open: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn die Operation beginnt.
| |
progress: — Wird vom contentLoaderInfo-Objekt abgesetzt, wenn Daten in den Arbeitsspeicher übertragen werden.
| |
securityError: — Wird vom contentLoaderInfo-Objekts abgesetzt, wenn die LoaderContext.requestedContentParent-Eigenschaft festgelegt wurde und die Sicherheitssandbox von LoaderContext.requestedContentParent keinen Zugriff auf die geladene SWF-Datei hat.
| |
unload: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn ein geladenes Objekt entfernt wird.
|
Auslöser
ArgumentError — Wenn der Wert der length-Eigenschaft des ByteArray-Objekts nicht größer als 0 ist.
| |
IllegalOperationError — Wenn die Eigenschaft checkPolicyFile bzw. securityDomain des Parameters context nicht null ist.
| |
IllegalOperationError — Wenn die requestedContentParent-Eigenschaft des context-Parameters ein ProLoader ist.
| |
IllegalOperationError — Wenn der LoaderContext.parameters-Parameter nicht null ist und einige Werte aufweist, die keine Strings sind.
| |
SecurityError — Wenn die bereitgestellte applicationDomain-Eigenschaft der context-Eigenschaft aus einer nicht zulässigen Domäne stammt.
| |
SecurityError — Eine Verbindung mit normalerweise reservierten Ports ist nicht möglich. Eine vollständige Liste der gesperrten Ports finden Sie unter „Beschränken von Netzwerk-APIs“ im ActionScript 3.0 Entwicklerhandbuch.
|
Verwandte API-Elemente
loadFilePromise | () | Methode |
public function loadFilePromise(promise:Object, context:LoaderContext = null):void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Laufzeitversionen: | AIR 2.5, AIR 2.0, Flash Player 9 |
Lädt eine IFilePromise-Instanz über den promise-Parameter. Der Typ des promise-Parameters verwendet die Object-Superklasse anstatt IFilePromise, um Fehler in anderen Playern zu vermeiden.
Die loadFilePromise-Methode verwendet ein IFilePromise-Objekt und lädt die Binärdaten. Wenn es sich bei den Daten um einen progressiven Stream handelt, zum Beispiel ein Video, warten Sie auf die „init“- oder Fortschrittsereignisse, bevor Sie auf die Eigenschaften des geladenen Objekts zugreifen. Warten Sie andernfalls auf das complete-Ereignis, um sicherzustellen, dass die Daten vollständig geladen wurden.
Wenn Sie diese Methode verwenden, berücksichtigen Sie das Flash Player-Sicherheitsmodell, das in der ProLoader-Klassenbeschreibung beschrieben wird.
Parameter
promise:Object — Ein IFilePromise-Objekt. Die Datenquelle des Objekts kann eines der von ProLoader-Klasse unterstützten Dateiformate aufweisen: SWF, GIF, JPEG oder PNG.
| |
context:LoaderContext (default = null)applicationDomain-Eigenschaft des LoaderContext-Objekts kann angewendet werden, nicht jedoch die Eigenschaften checkPolicyFile und securityDomain des LoaderContext-Objekts.
Wenn der Weitere Informationen zum Thema Sicherheit finden Sie im Flash Player Developer Center im Abschnitt Sicherheit. |
Ereignisse
asyncError: — Wird vom contentLoaderInfo-Objekt abgesetzt, wenn die LoaderContext.requestedContentParent-Eigenschaft festgelegt wurde und es nicht möglich ist, den geladenen Inhalt als untergeordnetes Element zum angegebenen DisplayObjectContainer hinzuzufügen. Dazu kann es kommen, wenn der geladene Inhalt ein flash.display.AVM1Movie ist oder wenn der addChild()-Aufruf an requestedContentParent einen Fehler ausgibt.
| |
complete: — Wird vom contentLoaderInfo-Objekt abgesetzt, wenn die Operation abgeschlossen ist. Das Ereignis complete wird immer nach dem Ereignis init ausgelöst.
| |
init: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn die Eigenschaften und Methoden der geladenen Daten zugänglich sind. Das Ereignis init wird immer vor dem Ereignis complete ausgelöst.
| |
ioError: — Wird vom contentLoaderInfo-Objekt abgesetzt, wenn die Laufzeitumgebung die Daten in der Datenquelle nicht analysieren kann oder wenn der Datenquellenstream nicht lesbar ist.
| |
open: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn die Operation beginnt.
| |
progress: — Wird vom contentLoaderInfo-Objekt abgesetzt, wenn Daten in den Arbeitsspeicher übertragen werden.
| |
securityError: — Wird vom contentLoaderInfo-Objekts abgesetzt, wenn die LoaderContext.requestedContentParent-Eigenschaft festgelegt wurde und die Sicherheitssandbox von LoaderContext.requestedContentParent keinen Zugriff auf die geladene SWF-Datei hat.
| |
unload: — Wird vom contentLoaderInfo-Objekt ausgelöst, wenn ein geladenes Objekt entfernt wird.
Warnung: Außerhalb einer AIR-Anwendung führt der Aufruf dieser API zu einem Fehler. |
Auslöser
IllegalOperationError — Wenn die requestedContentParent-Eigenschaft des context-Parameters ein ProLoader ist.
| |
IllegalOperationError — Wenn der LoaderContext.parameters-Parameter nicht null ist und einige Werte aufweist, die keine Strings sind.
| |
ArgumentError — Wenn das als Parameter übergebenen IFilePromise-Objekt null ist.
|
Verwandte API-Elemente
unload | () | Methode |
public function unload():void| Sprachversion: | ActionScript 3.0 |
| Produktversion: | Flash CS5.5 |
| Laufzeitversionen: | AIR 1.0, Flash Player 9 |
Entfernt ein untergeordnetes Element dieses ProLoader-Objekts, das mit der load()-Methode geladen wurde. Die property des zugeordneten ProLoaderInfo-Objekts wird auf null zurückgesetzt. Das untergeordnete Element wird nicht unbedingt zerstört, da andere Objekte möglicherweise darauf verweisen; es ist jedoch kein untergeordnetes Element des ProLoader-Objekts mehr.
Es ist ratsam, vor dem Entladen einer untergeordneten SWF-Datei alle Streams in deren Objekten, z. B. LocalConnection-, NetConnection-, NetStream- oder Sound-Objekte, ausdrücklich zu schließen. Andernfalls kann es passieren, dass Audiodaten in der untergeordneten SWF-Datei unaufhörlich abgespielt werden, obwohl die SWF-Datei selbst bereits entladen worden ist. Um Streams in der untergeordneten SWF-Datei zu schließen, fügen Sie dem untergeordneten Objekt, das auf das unload-Ereignis wartet, einen Ereignis-Listener hinzu. Wenn das übergeordnete Element ProLoader.unload() aufruft, wird das unload-Ereignis an das untergeordnete Element abgesetzt. Im folgenden Code wird gezeigt, wie Sie dies realisieren können:
function closeAllStreams(evt:Event) {
myNetStream.close();
mySound.close();
myNetConnection.close();
myLocalConnection.close();
}
myMovieClip.loaderInfo.addEventListener(Event.UNLOAD, closeAllStreams);
Verwandte API-Elemente
Tue Jun 12 2018, 10:04 AM Z