| Paket | flash.html |
| Klasse | public class HTMLLoader |
| Vererbung | HTMLLoader  Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
| Unterklassen | FlexHTMLLoader |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Unterstützung von AIR-Profilen: Diese Funktion wird auf allen Desktopbetriebssystemen unterstützt, jedoch nicht auf mobilen Geräten oder Geräten mit AIR für TV. Mit der HTMLLoader.isSupported-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Auf Desktopcomputern (Im Desktop- und erweiterten Desktopprofilen) verwendet die HTMLLoader-Klasse die interne AIR WebKit-Engine. Die verfügbaren Funktionen und die Darstellung sind die gleichen wie bei der StageWebView-Klasse, plus enge Integration und Skriptbrücke zwischen ActionScript und JavaScript. Da die StageWebView-Klasse die von Flash Player bereitgestellte Systemwebkontrolle verwendet, wird von der gleichzeitigen Verwendung von Instanzen von StageWebView und HTMLLoader stark abgeraten, da dies für undefiniertes Verhalten sorgt und die Anwendung möglicherweise beenden kann.
Die Standardabmessungen eines HTMLLoader sind 0 x 0 Pixel. Stellen Sie die width- und height-Eigenschaften ein, um das HTMLLoader-Objekt sichtbar zu machen.
Die maximale Größe eines HTMLLoader-Objekts ist 4.096 Pixel mal 4.096 Pixel. Das Einstellen von width oder height eines HTMLLoader-Objekts auf einen Wert, der 4.095 überschreitet, verursacht die Ausgabe einer ArgumentError-Ausnahme durch das HTMLLoader-Objekt. (In Versionen vor AIR 2 war die maximale Größe eines HTMLLoader-Objekts 2.880 Pixel.)
Hinweis: Bei der Anzeige in einem transparenten Fenster muss in eine HTML-Seite eingebetteter SWF-Inhalt mithilfe des transparent oder opaque-„wmode“ eingebettet sein. Der Standardwert für „wmode“ ist window, wenn Sie keinen Wert angeben, wird SWF-Inhalt möglicherweise nicht angezeigt. Unter Windows und Linux wird SWF-Inhalt immer im Vordergrund vor anderen Inhalten angezeigt, wenn wmode auf window oder opaque gesetzt ist. PDF-Inhalt kann nicht in einem transparenten Fenster angezeigt werden, unabhängig von der Einstellung für wmode.
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 | |
| authenticate : Boolean
Gibt an, ob Authentifizierungsanforderungen für die von diesem Objekt ausgegebenen HTTP-Anforderungen verarbeitet werden (true) oder nicht (false). | HTMLLoader | ||
| 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 | |
| cacheResponse : Boolean
Gibt an, ob für HTTP-Anforderungen, die von diesem Objekt ausgegeben werden, erfolgreiche Antwortdaten im Cache zwischengespeichert werden sollen. | HTMLLoader | ||
| constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| contentHeight : Number [schreibgeschützt]
Die Höhe des HTML-Inhalts in Pixeln. | HTMLLoader | ||
| contentWidth : Number [schreibgeschützt]
Die Breite des HTML-Inhalts in Pixeln. | HTMLLoader | ||
| 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 | |
| hasFocusableContent : Boolean [schreibgeschützt]
Gibt an, ob Inhalt im HTMLLoader-Objekt den Fokus erhalten kann. | HTMLLoader | ||
| height : Number [override]
Legt die Höhe des Rechtecks der dargestellten HTML-Leinwand fest. | HTMLLoader | ||
| historyLength : uint [schreibgeschützt]
Die Gesamtlänge der Verlaufsliste, einschließlich der Zurück- und Weiter-Einträge. | HTMLLoader | ||
| historyPosition : uint
Die aktuelle Position in der Verlaufsliste. | HTMLLoader | ||
| hitArea : Sprite
Gibt als Kollisionsbereich für ein Sprite ein anderes Sprite an. | Sprite | |
| htmlHost : flash.html:HTMLHost
Das HTMLHost-Objekt, das verwendet wird, um Änderungen an bestimmten Elementen der Benutzeroberfläche zu verarbeiten, zum Beispiel die window.document.title-Eigenschaft des HTMLLoader-Objekts. | HTMLLoader | ||
| idleTimeout : Number
Legt den Wert für die Zeitüberschreitung (in Millisekunden) für HTTP-Anforderungen, die von diesem Objekt ausgegeben werden, fest. | HTMLLoader | ||
| isSupported : Boolean [statisch] [schreibgeschützt]
Gibt an, ob die HTMLLoader-Klasse vom Clientsystem unterstützt wird. | HTMLLoader | ||
| loaded : Boolean [schreibgeschützt]
Zeigt an, ob das JavaScript-load-Ereignis, das dem vorherigen Aufruf der load()- oder loadString()-Methode entspricht, dem HTML-DOM im HTMLLoader-Objekt übergeben wurde. | HTMLLoader | ||
| loaderInfo : LoaderInfo [schreibgeschützt]
Gibt ein LoaderInfo-Objekt mit Informationen zum Laden der Datei zurück, zu der dieses Anzeigeobjekt gehört. | DisplayObject | |
| location : String [schreibgeschützt]
Die URL für den in das HTMLLoader-Objekt geladenen Inhalt. | HTMLLoader | ||
| manageCookies : Boolean
Gibt an, ob der HTTP-Protokoll-Stack Cookies für dieses Objekt verwalten soll. | HTMLLoader | ||
| 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 | |
| navigateInSystemBrowser : Boolean
Gibt an, ob das Navigieren im Stammbild des HTML-Inhalts (zum Beispiel, wenn der Benutzer auf einen Link klickt, wenn die window.location-Eigenschaft festgelegt wurde, oder wenn window.open() aufgerufen wird) zur Navigation im HTMLLoader-Objekt (false) oder im Standardwebbrowser des Systems (true) führt. | HTMLLoader | ||
| 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 | |
| paintsDefaultBackground : Boolean
Gibt an, ob der Hintergrund des HTMLLoader-Dokuments undurchsichtig weiß ist (true) oder nicht (false). | HTMLLoader | ||
| parent : DisplayObjectContainer [schreibgeschützt]
Gibt das DisplayObjectContainer-Objekt an, das dieses Anzeigeobjekt enthält. | DisplayObject | |
| pdfCapability : int [statisch] [schreibgeschützt]
Die Art der PDF-Unterstützung auf dem System des Benutzers, definiert als Ganzzahlencodewert. | HTMLLoader | ||
| placeLoadStringContentInApplicationSandbox : Boolean
Gibt an, ob Inhalte, die mittels der loadString()-Methode geladen wurden, in der Anwendungssandbox („true“) oder in einer anwendungsfremden Sandbox („false“) abgelegt werden. | HTMLLoader | ||
| 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 | |
| runtimeApplicationDomain : ApplicationDomain
Die Anwendungsdomäne, die für das window.runtime-Objekt im JavaScript-Code der HTML-Seite verwendet wird. | HTMLLoader | ||
| 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 | |
| scrollH : Number
Die horizontale Bildlaufposition des HTML-Inhalts innerhalb des HTMLLoader-Objekts. | HTMLLoader | ||
| scrollRect : Rectangle
Die Begrenzungen des Bildlaufrechtecks für das Anzeigeobjekt. | DisplayObject | |
| scrollV : Number
Die vertikale Bildlaufposition des HTML-Inhalts innerhalb des HTMLLoader-Objekts. | HTMLLoader | ||
| 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 | |
| swfCapability : int [statisch] [schreibgeschützt]
Die Art der SWF-Unterstützung auf dem System des Benutzers, definiert als Ganzzahlencodewert. | HTMLLoader | ||
| 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 | |
| textEncodingFallback : String
Die Zeichenkodierung, die vom HTMLLoader-Inhalt verwendet wird, wenn eine HTML-Seite keine Zeichenkodierung festlegt. | HTMLLoader | ||
| textEncodingOverride : String
Die Zeichenkodierung, die vom HTMLLoader-Inhalt verwendet wird, wobei alle Einstellungen auf der HTML-Seite überschrieben werden. | HTMLLoader | ||
| 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 | |
| useCache : Boolean
Gibt an, ob der lokale Cache geprüft werden soll, bevor HTTP-Anforderungen, die von diesem Objekt ausgegeben wurden, Daten abrufen. | HTMLLoader | ||
| 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 | |
| userAgent : String
Der Benutzer-Agent-String, der in zukünftigen Inhaltsanforderungen von diesem HTMLLoader-Objekt verwendet wird. | HTMLLoader | ||
| visible : Boolean
Gibt an, ob das Anzeigeobjekt sichtbar ist oder nicht. | DisplayObject | |
| width : Number [override]
Legt die Breite des Rechtecks der dargestellten HTML-Leinwand fest. | HTMLLoader | ||
| window : Object [schreibgeschützt]
Das globale JavaScript-Objekt für den Inhalt, der in das HTML-Steuerelement geladen wird. | HTMLLoader | ||
| 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 HTMLLoader-Objekt. | HTMLLoader | ||
|
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 alle zurzeit stattfindenden Ladevorgänge ab. | HTMLLoader | ||
|
Ermittelt, ob das angegebene Anzeigeobjekt der DisplayObjectContainer-Instanz oder der Instanz selbst untergeordnet ist. | DisplayObjectContainer | |
createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader [statisch]
Erstellt ein neues NativeWindow-Objekt, das ein HTMLLoader-Objekt enthält. | HTMLLoader | ||
|
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 den Verlaufseintrag an der angegebenen Position zurück. | HTMLLoader | ||
|
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 | |
Navigiert im Browserverlauf zurück, sofern möglich. | HTMLLoader | ||
Navigiert im Browserverlauf vorwärts, sofern möglich. | HTMLLoader | ||
Navigiert die angegebene Anzahl von Schritten im Browserverlauf. | HTMLLoader | ||
|
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 das HTMLLoader-Objekt mit Daten von der Seite, die durch den urlRequestToLoad-Parameter angegeben wird. | HTMLLoader | ||
Lädt das HTMLLoader-Objekt mit dem HTML-Inhalt, der im HTML-String enthalten ist. | HTMLLoader | ||
|
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 | |
Lädt die Seite vom aktuellen Speicherort neu. | HTMLLoader | ||
|
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 | |
|
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 | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn ein Objekt der Anzeigeliste hinzugefügt wird. | DisplayObject | ||
| Wird ausgelöst, wenn ein Anzeigeobjekt der Anzeigeliste für die Bühne hinzugefügt wird. Dies erfolgt entweder direkt oder über das Hinzufügen einer Unterstruktur, die das Anzeigeobjekt enthält. | DisplayObject | ||
| Wird ausgelöst, wenn der Benutzer aus dem Kontextmenü die Option „Löschen“ wählt. | InteractiveObject | ||
| Wird ausgelöst, wenn ein Benutzer die Haupttaste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und wieder loslässt. | InteractiveObject | ||
| Gibt an, dass der letzte Ladevorgang, der von der loadString- oder der load-Methode angefordert wurde, abgeschlossen ist. | HTMLLoader | |||
| Wird ausgelöst, wenn der Benutzer das Kontextmenü, das mit diesem interaktiven Objekt verknüpft ist, in einer AIR-Anwendung einblendet. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Kopieren“ aktiviert oder im Kontextmenü des Texts „Kopieren“ wählt. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Ausschneiden“ aktiviert oder im Kontextmenü des Texts „Ausschneiden“ wählt. | InteractiveObject | ||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| Wird ausgelöst, wenn der Benutzer die Haupttaste des Zeigegeräts zweimal schnell hintereinander über dem gleichen InteractiveObject-Objekt drückt und das doubleClickEnabled-Flag des Objekts „true“ lautet. | InteractiveObject | ||
| [broadcast event] Wird ausgelöst, wenn der Abspielkopf ein neues Bild erreicht. | DisplayObject | ||
| [broadcast event] Wird ausgelöst, wenn der Abspielkopf das aktuelle Bild verlässt. | DisplayObject | ||
| Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus erhalten hat. | InteractiveObject | ||
| Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus verloren hat. | InteractiveObject | ||
| [broadcast event] Wird ausgelöst, nachdem die Konstruktoren von Bildanzeigeobjekten ausgeführt wurden, bevor Bildskripten ausgeführt wurden. | DisplayObject | ||
| Wird abgesetzt, wenn der Benutzer einen Kontaktpunkt entlang der Kante der Touch-Oberfläche mit einer InteractiveObject-Instanz erstellt (z. B. durch Tippen entlang der Kante der Touch-Oberfläche auf Siri Remote für Apple TV). Bei einigen Geräten könnte dieser Kontakt auch als eine Kombination von verschiedenen Kontaktereignissen ausgelegt werden. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer auf zwei Kontaktpunkte über derselben InteractiveObject-Instanz auf einem berührungsempfindlichen Gerät drückt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen zwei Finger auf ein Anzeigeobjekt drückt und wieder loslässt). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer einen Berührungspunkt über die InteractiveObject-Instanz auf einem berührungsempfindlichen Gerät bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger über ein Anzeigeobjekt von links nach rechts bewegt). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer eine Drehgeste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit zwei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann über einem Anzeigeobjekt dreht). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer eine Swipe-Geste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit drei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann parallel über ein Anzeigeobjekt bewegt). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer einen Kontaktpunkt mit einer InteractiveObject-Instanz erstellt und dann auf ein berührungsempfindliches Gerät tippt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen mehrere Finger auf einem Anzeigeobjekt platziert, um ein Menü zu öffnen, und dann mit einem Finger tippt, um einen Menüpunkt auszuwählen). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer eine Zoom-Geste an einem Kontaktpunkt mit einer InteractiveObject-Instanz ausführt (zum Beispiel mit zwei Fingern den Bildschirm eines Mobiltelefons oder Tablets berührt und die Finger dann schnell über einem Anzeigeobjekt spreizt). | InteractiveObject | ||
| Gibt an, dass mindestens eine der Eigenschaften contentWidth und contentHeight eines HTMLLoader-Objekts geändert wurde. | HTMLLoader | |||
| Gibt an, dass das HTML-DOM als Antwort auf einen Ladevorgang erstellt wurde. | HTMLLoader | |||
| Gibt an, dass die Darstellung des Inhalts im HTMLLoader-Objekt auf dem neuesten Stand ist. | HTMLLoader | |||
| Dieses Ereignis wird an jede Client-Anwendung abgesetzt, die die Inline-Eingabe mit einem IME unterstützt | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer eine Taste drückt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe der Tastatur zu ändern. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer eine Taste loslässt. | InteractiveObject | ||
| Gibt an, dass die location-Eigenschaft des HTMLLoader-Objekts geändert wurde. | HTMLLoader | |||
| Gibt an, dass die location-Eigenschaft des HTMLLoader-Objekts geändert wurde. | HTMLLoader | |||
| Zeigt an, dass sich die location-Eigenschaft des HTMLLoader-Objekts gleich ändert. | HTMLLoader | |||
| Wird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe eines Zeigegeräts zu ändern. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer das Zeigegerät bewegt, während es sich auf einer InteractiveObject-Instanz befindet. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt. | InteractiveObject | ||
| Wird ausgelöst, wenn das Mausrad über einer InteractiveObject-Instanz gedreht wird. | InteractiveObject | ||
| Wird vom InteractiveObject-Ziehinitiator ausgelöst, wenn der Benutzer die Ziehbewegung beendet. | InteractiveObject | ||
| Wird vom InteractiveObject-Zielobjekt ausgelöst, wenn ein gezogenes Objekt darauf abgelegt wird und das Ablegen mit einem Aufruf von „DragManager.acceptDragDrop()“ akzeptiert wurde. | InteractiveObject | ||
| Wird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung in ihre Begrenzungen eintritt. | InteractiveObject | ||
| Wird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung ihre Begrenzungen verlässt. | InteractiveObject | ||
| Wird von einer InteractiveObject-Instanz kontinuierlich ausgelöst, während eine Ziehbewegung innerhalb ihrer Begrenzungen verbleibt. | InteractiveObject | ||
| Wird am Anfang eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist. | InteractiveObject | ||
| Wird während eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Einfügen“ aktiviert oder im Kontextmenü des Texts „Einfügen“ wählt. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift unter den Schwellenwert für die Abstandserkennung des Bildschirms senkt. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift über den Schwellenwert für die Abstandserkennung des Bildschirms anhebt. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift über den Bildschirm bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung bleibt. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift von diesem InteractiveObject wegbewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift direkt über dieses InteractiveObject bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift von diesem InteractiveObject und seinen untergeordneten Elementen wegbewegt, während er innerhalb des Schwellenwerts der Abstandserkennung auf dem Bildschirm bleibt. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift von außerhalb der Nachfolgerstruktur des Objekts in der Anzeigeliste über dieses InteractiveObject bewegt (und dabei innerhalb des Schwellenwerts für die Abstandserkennung auf dem Bildschirm bleibt). | InteractiveObject | ||
| Wird abgesetzt, wenn ein Benutzer die Taste des Zeigegeräts loslässt, nachdem er die Taste über einer InteractiveObject-Instanz gedrückt und das Zeigegerät dann von der InteractiveObject-Instanz wegbewegt hat. | InteractiveObject | ||
| Wird ausgelöst, wenn ein Objekt aus der Anzeigeliste entfernt werden soll. | DisplayObject | ||
| Wird ausgelöst, wenn ein Anzeigeobjekt aus der Anzeigeliste entfernt werden soll. Dies erfolgt entweder direkt oder über das Entfernen einer Unterstruktur, die das Anzeigeobjekt enthält. | DisplayObject | ||
| [broadcast event] Wird ausgelöst, wenn die Anzeigeliste kurz davor steht, aktualisiert und neu gezeichnet zu werden. | DisplayObject | ||
| Wird ausgelöst, wenn der Benutzer die rechte Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt. | InteractiveObject | ||
| Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt. | InteractiveObject | ||
| Gibt an, dass die scrollH- oder scrollV-Eigenschaft vom HTMLLoader-Objekt geändert wurde. | HTMLLoader | |||
| Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Alles auswählen“ aktiviert oder im Kontextmenü des Texts „Alles auswählen“ wählt. | InteractiveObject | ||
| Wird sofort nach dem Einblenden der Softwaretastatur abgesetzt. | InteractiveObject | ||
| Wird direkt vor dem Einblenden der Softwaretastatur abgesetzt. | InteractiveObject | ||
| Wird sofort nach dem Ausblenden der Softwaretastatur abgesetzt. | InteractiveObject | ||
| Wird ausgelöst, wenn sich der Wert des tabChildren-Flags des Objekts ändert. | InteractiveObject | ||
| Wird ausgelöst, wenn sich das tabEnabled-Flag des Objekts ändert. | InteractiveObject | ||
| Wird ausgelöst, wenn sich der Wert der tabIndex-Eigenschaft des Objekts ändert. | InteractiveObject | ||
| Wird ausgelöst, wenn ein Benutzer ein oder mehrere Textzeichen eingibt. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer ein berührungsempfindliches Gerät erstmals berührt (zum Beispiel mit dem Finger das Touchscreen eines Mobiltelefons oder Tablets berührt). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät entfernt (zum Beispiel den Finger vom Touchscreen eines Mobiltelefons oder Tablets hebt). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer das Gerät berührt, und zwar kontinuierlich, bis der Kontaktpunkt entfernt wird. | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät von einer InteractiveObject-Instanz wegbewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Anzeigeobjekt zu einem anderen zieht). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät über eine InteractiveObject-Instanz bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Punkt außerhalb des Anzeigeobjekts auf einen Punkt über einem Anzeigeobjekt zieht). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät von einer InteractiveObject-Instanz wegbewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Anzeigeobjekt auf einen Punkt außerhalb des Anzeigeobjekts zieht). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer den Kontaktpunkt bei einem berührungsempfindlichen Gerät über eine InteractiveObject-Instanz bewegt (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem Punkt außerhalb des Anzeigeobjekts auf einen Punkt über einem Anzeigeobjekt zieht). | InteractiveObject | ||
| Wird abgesetzt, wenn der Benutzer den Kontaktpunkt über derselben InteractiveObject-Instanz anhebt, auf der der Kontakt eingeleitet wurde (zum Beispiel bei einem Mobiltelefon oder Tablet mit Touchscreen einen Finger von einem einzelnen Kontaktpunkt hebt). | InteractiveObject | ||
| Gibt an, dass im HTMLLoader-Objekt eine nicht erfasste JavaScript-Ausnahme aufgetreten ist. | HTMLLoader | |||
authenticate | Eigenschaft |
authenticate:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Gibt an, ob Authentifizierungsanforderungen für die von diesem Objekt ausgegebenen HTTP-Anforderungen verarbeitet werden (true) oder nicht (false). Bei der Einstellung false geben Authentifizierungsfehlversuche einen HTTP-Fehler zurück.
Der Standardwert ist initialized from URLRequestDefaults.authenticate.
Implementierung
public function get authenticate():Boolean public function set authenticate(value:Boolean):voidVerwandte API-Elemente
cacheResponse | Eigenschaft |
cacheResponse:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Gibt an, ob für HTTP-Anforderungen, die von diesem Objekt ausgegeben werden, erfolgreiche Antwortdaten im Cache zwischengespeichert werden sollen. Bei der Einstellung true verwendet das HTMLLoader-Objekt den HTTP-Cache des Betriebssystems.
Der Standardwert ist initialized from URLRequestDefaults.cacheResponse.
Implementierung
public function get cacheResponse():Boolean public function set cacheResponse(value:Boolean):voidVerwandte API-Elemente
contentHeight | Eigenschaft |
contentHeight:Number [schreibgeschützt] | Laufzeitversionen: | AIR 1.0 |
Die Höhe des HTML-Inhalts in Pixeln. Diese Eigenschaft kann sich ändern, wenn sich die Abmessungen des HTMLLoader-Objekts ändern. Eine HTML-Seite verwendet zum Beispiel oft die gesamte Höhe des HTMLLoader-Objekts und die contentHeight-Eigenschaft kann sich ändern, wenn Sie die Höhe des HTMLLoader-Objekts ändern.
Implementierung
public function get contentHeight():Number contentWidth | Eigenschaft |
contentWidth:Number [schreibgeschützt] | Laufzeitversionen: | AIR 1.0 |
Die Breite des HTML-Inhalts in Pixeln. Diese Eigenschaft kann sich ändern, wenn sich die Abmessungen des HTMLLoader-Objekts ändern. Eine HTML-Seite verwendet zum Beispiel oft die gesamte Breite des HTMLLoader-Objekts und die contentWidth-Eigenschaft kann sich ändern, wenn Sie die Breite des HTMLLoader-Objekts ändern.
Implementierung
public function get contentWidth():Number hasFocusableContent | Eigenschaft |
height | Eigenschaft |
height:Number[override] | Laufzeitversionen: | AIR 1.0 |
Legt die Höhe des Rechtecks der dargestellten HTML-Leinwand fest. Diese Eigenschaft ist die Höhe des HTMLLoader-Anzeigeobjekts in Pixel. Der Höchstwert für height beträgt 4095 Pixel. Wenn diese Eigenschaft geändert wird, wird das HTML-Dokument vom HTMLLoader-Objekt erneut dargestellt. htmlBoundsChanged-Ereignisse werden ggf. als Reaktion auf eine Änderung dieser Eigenschaft ausgelöst.
Wenn Sie die width- oder height-Eigenschaft eines HTMLLoader-Objekts einstellen, werden die Grenzen des Objekts geändert, der Inhalt wird jedoch nicht skaliert (wie es bei anderen Anzeigeobjekttypen passieren würde).
Implementierung
override public function get height():Number override public function set height(value:Number):void historyLength | Eigenschaft |
historyLength:uint [schreibgeschützt] | Laufzeitversionen: | AIR 1.0 |
Die Gesamtlänge der Verlaufsliste, einschließlich der Zurück- und Weiter-Einträge. Diese Eigenschaft hat denselben Wert wie die JavaScript-window.history.length-Eigenschaft der HTML-Seite.
Implementierung
public function get historyLength():uintVerwandte API-Elemente
historyPosition | Eigenschaft |
historyPosition:uint| Laufzeitversionen: | AIR 1.0 |
Die aktuelle Position in der Verlaufsliste. Die Verlaufsliste entspricht dem window.history-Objekt der HTML-Seite. Einträge, die geringer sind als die aktuelle Position, sind die „Zurück“-Liste, größere Einträge sind die „Weiter“-Liste. Durch den Versuch, eine Position einzustellen, die jenseits vom Ende liegt, wird der Wert auf das Ende festgelegt.
Implementierung
public function get historyPosition():uint public function set historyPosition(value:uint):voidVerwandte API-Elemente
htmlHost | Eigenschaft |
htmlHost:flash.html:HTMLHost| Laufzeitversionen: | AIR 1.0 |
Das HTMLHost-Objekt, das verwendet wird, um Änderungen an bestimmten Elementen der Benutzeroberfläche zu verarbeiten, zum Beispiel die window.document.title-Eigenschaft des HTMLLoader-Objekts. Um Standardverhalten für das HTMLLoader-Objekt zu überschreiben, erstellen Sie eine Unterklasse der HTMLHost-Klasse und überschreiben Sie damit ihre Mitgliederfunktionen, um verschiedene Benutzeroberflächenänderungen im HTML-Inhalt zu verarbeiten.
Implementierung
public function get htmlHost():flash.html:HTMLHost public function set htmlHost(value:flash.html:HTMLHost):voidVerwandte API-Elemente
idleTimeout | Eigenschaft |
idleTimeout:Number| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 2 |
Legt den Wert für die Zeitüberschreitung (in Millisekunden) für HTTP-Anforderungen, die von diesem Objekt ausgegeben werden, fest.
Die Leerlaufzeitsperre ist die Zeitspanne, die der Client nach dem Herstellen der Verbindung auf eine Antwort vom Server wartet, bevor die Anforderung abgebrochen wird.
Der Standardwert ist initialized from URLRequestDefaults.idleTimeout.
Implementierung
public function get idleTimeout():Number public function set idleTimeout(value:Number):voidVerwandte API-Elemente
isSupported | Eigenschaft |
loaded | Eigenschaft |
loaded:Boolean [schreibgeschützt] | Laufzeitversionen: | AIR 1.0 |
Zeigt an, ob das JavaScript-load-Ereignis, das dem vorherigen Aufruf der load()- oder loadString()-Methode entspricht, dem HTML-DOM im HTMLLoader-Objekt übergeben wurde. Diese Eigenschaft hat den Wert true, bevor das complete-Ereignis ausgelöst wird. Es ist möglich, dass diese Eigenschaft nie mit dem Wert true belegt wird. Dies passiert in den gleichen Fällen, in denen auch das complete-Ereignis nicht ausgelöst wird.
Implementierung
public function get loaded():Boolean location | Eigenschaft |
manageCookies | Eigenschaft |
manageCookies:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Gibt an, ob der HTTP-Protokoll-Stack Cookies für dieses Objekt verwalten soll. Bei der Einstellung true werden der Anforderung Cookies hinzugefügt und Antwortcookies werden gespeichert. Bei der Einstellung false werden Cookies nicht zur Anforderung hinzugefügt und Antwortcookies werden nicht gespeichert.
Der Standardwert ist initialized from URLRequestDefaults.manageCookies.
Implementierung
public function get manageCookies():Boolean public function set manageCookies(value:Boolean):voidVerwandte API-Elemente
navigateInSystemBrowser | Eigenschaft |
navigateInSystemBrowser:Boolean| Laufzeitversionen: | AIR 1.0 |
Gibt an, ob das Navigieren im Stammbild des HTML-Inhalts (zum Beispiel, wenn der Benutzer auf einen Link klickt, wenn die window.location-Eigenschaft festgelegt wurde, oder wenn window.open() aufgerufen wird) zur Navigation im HTMLLoader-Objekt (false) oder im Standardwebbrowser des Systems (true) führt. Stellen Sie diese Eigenschaft auf true ein, wenn die gesamte Navigation im Webbrowser des Systems (nicht im HTMLLoader-Objekt) stattfinden soll.
Der Standardwert ist false.
Implementierung
public function get navigateInSystemBrowser():Boolean public function set navigateInSystemBrowser(value:Boolean):void paintsDefaultBackground | Eigenschaft |
paintsDefaultBackground:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Gibt an, ob der Hintergrund des HTMLLoader-Dokuments undurchsichtig weiß ist true oder nicht false. Wenn diese Eigenschaft den Wert false besitzt, verwendet das HTMLLoader-Objekt seinen Anzeigeobjektcontainer als Hintergrund für den HTML-Code und die Opazität (Alpha-Wert) des Anzeigeobjektcontainers als HTML-Hintergrund. Wenn jedoch das body-Element oder ein anderes Element des HTML-Dokuments eine undurchsichtige Hintergrundfarbe aufweist (festgelegt z. B. durch style="background-color:gray"), wird für diesen Teil des wiedergegebenen HTML-Codes die angegebene undurchsichtige Hintergrundfarbe verwendet.
Implementierung
public function get paintsDefaultBackground():Boolean public function set paintsDefaultBackground(value:Boolean):void pdfCapability | Eigenschaft |
pdfCapability:int [schreibgeschützt] | Laufzeitversionen: | AIR 1.0 |
Die Art der PDF-Unterstützung auf dem System des Benutzers, definiert als Ganzzahlencodewert. Ein HTMLLoader-Objekt kann PDF-Inhalte nur dann anzeigen, wenn diese Eigenschaft PDFCapability.STATUS_OK entspricht. Die PDFCapability-Klasse definiert Konstanten für mögliche Werte der pdfCapability-Eigenschaft wie folgt:
| PDFCapability-Konstante | Bedeutung |
|---|---|
STATUS_OK | Eine ausreichende Version (8.1 oder höher) von Acrobat oder Adobe Reader wurde erkannt. PDF-Inhalte können in ein HTMLLoader-Objekt geladen werden.
Hinweis: Wenn unter Windows Acrobat oder Adobe Reader Version 7.x oder höher auf dem System des Benutzers ausgeführt wird, wird diese Version verwendet, auch wenn eine höhere Version installiert ist, die das Laden von im HTMLLoader-Objekt geladenen PDF-Inhalten unterstützt. In diesem Fall gilt: Wenn der Wert der |
ERROR_INSTALLED_READER_NOT_FOUND | Es wurde keine Version von Acrobat oder Adobe Reader erkannt. Ein HTMLLoader-Objekt kann PDF-Inhalt nicht anzeigen. |
ERROR_INSTALLED_READER_TOO_OLD | Acrobat oder Adobe Reader wurde erkannt, die Version ist jedoch zu alt. Ein HTMLLoader-Objekt kann PDF-Inhalt nicht anzeigen. |
ERROR_PREFERED_READER_TOO_OLD | Es wurde eine ausreichende Version (8.1 oder höher) von Acrobat oder Adobe Reader erkannt; jedoch ist die zum Verarbeiten von PDF-Inhalten eingerichtete Version älter als 8.1. Ein HTMLLoader-Objekt kann PDF-Inhalte nicht anzeigen. |
Implementierung
public static function get pdfCapability():intVerwandte API-Elemente
placeLoadStringContentInApplicationSandbox | Eigenschaft |
placeLoadStringContentInApplicationSandbox:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.5 |
Gibt an, ob Inhalte, die mittels der loadString()Methode geladen wurden, in der Anwendungssandbox (true) oder in einer anwendungsfremden Sandbox (false) abgelegt werden.
Wenn diese Eigenschaft auf false gesetzt ist, werden Inhalte, die mittels der loadString()-Methode geladen wurden, in einer anwendungsfremden Sandbox mit den folgenden Charakteristiken abgelegt.
- Sie hat Zugriff auf das Laden von Inhalten aus dem Netzwerk (jedoch nicht aus dem Dateisystem).
- Sie kann keine Daten mithilfe von XMLHttpRequest laden.
- Die
window.location-Eigenschaft ist auf"about:blank"gesetzt. - Die Inhalte können nicht auf die
window.runtime-Eigenschaft zugreifen (wie die Inhalte in anwendungsfremden Sandboxen).
Wenn diese Eigenschaft auf true gesetzt ist, werden die Inhalte, die mittels der loadString()-Methode geladen wurden, in der Anwendungssandbox abgelegt, mit gleichzeitigem Zugriff auf die window.runtime-Eigenschaft und auf alle AIR-APIs. Sie sollten sicherstellen, dass der Datenquelle für einen String, der in einem Aufruf der loadString()-Methode verwendet wird, vertraut wird. Code-Anweisungen im HTML-String werden mit vollen Anwendungsprivilegien ausgeführt, wenn diese Eigenschaft auf true gesetzt ist. Setzen Sie diese Eigenschaft nur dann auf true, wenn Sie sicher sind, dass der String keinen schädlichen Code enthalten kann.
In Anwendungen, die mit dem AIR 1.0- oder AIR 1.1-SDK kompiliert werden, werden die Inhalte, die mittels der loadString()-Methode geladen wurden, in der Anwendungssandbox abgelegt.
Der Standardwert ist false.
Implementierung
public function get placeLoadStringContentInApplicationSandbox():Boolean public function set placeLoadStringContentInApplicationSandbox(value:Boolean):voidVerwandte API-Elemente
runtimeApplicationDomain | Eigenschaft |
runtimeApplicationDomain:ApplicationDomain| Laufzeitversionen: | AIR 1.0 |
Die Anwendungsdomäne, die für das window.runtime-Objekt im JavaScript-Code der HTML-Seite verwendet wird.
Wenn sie null ist oder wenn der HTML-Inhalt aus einer anderen Sicherheitsdomäne als der SWF-Inhalt stammt, der das HTMLLoader-Objekt enthält, verwendet die Seite eine Standardanwendungsdomäne für ihre Domäne.
Implementierung
public function get runtimeApplicationDomain():ApplicationDomain public function set runtimeApplicationDomain(value:ApplicationDomain):voidAuslöser
SecurityError — wenn das ApplicationDomain-Objekt nicht aus der Sicherheitsdomäne des Aufrufers stammt.
|
Verwandte API-Elemente
scrollH | Eigenschaft |
scrollV | Eigenschaft |
swfCapability | Eigenschaft |
swfCapability:int [schreibgeschützt] | Laufzeitversionen: | AIR 2 |
Die Art der SWF-Unterstützung auf dem System des Benutzers, definiert als Ganzzahlencodewert. Ein HTMLLoader-Objekt kann SWF-Inhalte nur dann anzeigen, wenn diese Eigenschaft HTMLSWFCapability.STATUS_OK entspricht. Die HTMLSWFCapability-Klasse definiert Konstanten für mögliche Werte der swfCapability-Eigenschaft wie folgt:
| HTMLSWFCapability-Konstante | Bedeutung |
|---|---|
STATUS_OK | Es wurde eine ausreichende Version von Adobe Flash Player erkannt und der SWF-Inhalt kann in ein HTMLLoader-Objekt geladen werden. |
ERROR_INSTALLED_PLAYER_NOT_FOUND | Es wurde keine Version von Adobe Flash Player erkannt. Ein HTMLLoader-Objekt kann SWF-Inhalt nicht anzeigen. |
ERROR_INSTALLED_PLAYER_TOO_OLD | Adobe Flash Player wurde erkannt, die Version ist jedoch zu alt. Ein HTMLLoader-Objekt kann SWF-Inhalt nicht anzeigen. |
Implementierung
public static function get swfCapability():intVerwandte API-Elemente
textEncodingFallback | Eigenschaft |
textEncodingFallback:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Die Zeichenkodierung, die vom HTMLLoader-Inhalt verwendet wird, wenn eine HTML-Seite keine Zeichenkodierung festlegt. Auf HTML-Seiten wird die Zeichenkodierung in einem meta-Tag angegeben wie im folgenden Beispiel:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Werte sind in der IANA-Liste der gültigen Zeichensätze definiert.
Wenn von der HTML-Seite, von der textEncodingFallback-Eigenschaft oder der textEncodingOverride-Eigenschaft keine Kodierung festgelegt wird, verwendet der HTML-Inhalt die ISO-8859-1-Kodierung.
Implementierung
public function get textEncodingFallback():String public function set textEncodingFallback(value:String):voidVerwandte API-Elemente
textEncodingOverride | Eigenschaft |
textEncodingOverride:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Die Zeichenkodierung, die vom HTMLLoader-Inhalt verwendet wird, wobei alle Einstellungen auf der HTML-Seite überschrieben werden. Auf HTML-Seiten wird die Zeichenkodierung in einem meta-Tag angegeben wie im folgenden Beispiel:
<meta http-equiv="content-type" content="text/html" charset="ISO-8859-1">
Diese Einstellung überschreibt auch jede Einstellung in der textEncodingFallback-Eigenschaft.
Werte sind in der IANA-Liste der gültigen Zeichensätze definiert.
Setzen Sie die textEncodingOverride-Eigenschaft, nachdem der HTML-Inhalt geladen wurde, damit AIR den HTML-Inhalt mit der angegebenen Kodierung aktualisiert. Wenn der HTMLLoader zu einer neuen Seite navigiert, müssen Sie die Eigenschaft erneut setzen, falls die neue Seite eine bestimmte Kodierung verwenden soll.
Wenn von der HTML-Seite, von der textEncodingFallback-Eigenschaft oder der textEncodingOverride-Eigenschaft keine Kodierung festgelegt wird, verwendet der HTML-Inhalt die ISO-8859-1-Kodierung.
Durch das Festlegen der textEncodingOverride-Eigenschaft auf null wird das Standardverhalten wiederhergestellt.
Implementierung
public function get textEncodingOverride():String public function set textEncodingOverride(value:String):voidVerwandte API-Elemente
useCache | Eigenschaft |
useCache:Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Gibt an, ob der lokale Cache geprüft werden soll, bevor HTTP-Anforderungen, die von diesem Objekt ausgegeben wurden, Daten abrufen.
Der Standardwert ist initialized from URLRequestDefaults.useCache.
Implementierung
public function get useCache():Boolean public function set useCache(value:Boolean):voidVerwandte API-Elemente
userAgent | Eigenschaft |
userAgent:String| Laufzeitversionen: | AIR 1.0 |
Der Benutzer-Agent-String, der in zukünftigen Inhaltsanforderungen von diesem HTMLLoader-Objekt verwendet wird.
Um den Benutzer-Agent String festzulegen, stellen Sie die userAgent-Eigenschaft des HTMLLoader-Objekts ein, bevor Sie die load()-Methode aufrufen. Die userAgent-Eigenschaft des URLRequest-Objekts, das an die load()-Methode übergeben wird, wird nicht verwendet.
Sie können den Benutzer-Agent-Standardstring festlegen, der von allen HTMLLoader-Objekten in einer Anwendungsdomäne verwendet wird, indem Sie die URLRequestDefaults.userAgent-Eigenschaft einstellen. Wenn für die userAgent-Eigenschaft des HTMLLoader-Objekts kein Wert festgelegt wird (bzw. wenn der Wert auf null gesetzt ist), wird der Benutzer-Agent-String auf den Wert der statischen URLRequestDefaults.userAgent-Eigenschaft gesetzt.
Wenn weder für die userAgent-Eigenschaft des HTMLLoader noch für URLRequestDefaults.userAgent ein Wert festgelegt wurde, wird ein Standardwert als Benutzer-Agent-String verwendet. Dieser Standardwert variiert je nach dem Laufzeitbetriebssystem (z. B. Mac OS, Linux oder Windows), der Laufzeitsprache und der Laufzeitversion (siehe folgende Beispiele):
"Mozilla/5.0 (Macintosh; U; PPC Mac OS X; en) AppleWebKit/526.9+ (KHTML, wie Gecko) AdobeAIR/1.5""Mozilla/5.0 (Windows; U; en) AppleWebKit/526.9+ (KHTML, wie Gecko) AdobeAIR/1.5""Mozilla/5.0 (X11; U; Linux i686; en-US) AppleWebKit/526.9+ (KHTML, wie Gecko) AdobeAIR/1.5"
Implementierung
public function get userAgent():String public function set userAgent(value:String):voidVerwandte API-Elemente
width | Eigenschaft |
width:Number[override] | Laufzeitversionen: | AIR 1.0 |
Legt die Breite des Rechtecks der dargestellten HTML-Leinwand fest. Dies ist die Breite des HTMLLoader-Anzeigeobjekts in Pixel. Der Höchstwert für width beträgt 4095 Pixel. Wenn diese Eigenschaft geändert wird, wird das HTML-Dokument vom HTMLLoader-Objekt erneut dargestellt. Eine Änderung dieser Eigenschaft kann htmlBoundsChange-Ereignisse auslösen. Wenn Sie die width- und height-Eigenschaft eines HTMLLoader-Objekts festlegen, ändern sich die Grenzen des Objekts, aber der Inhalt wird nicht skaliert (so wie es auch bei anderen Typen von Anzeigeobjekten der Fall wäre).
Implementierung
override public function get width():Number override public function set width(value:Number):void window | Eigenschaft |
HTMLLoader | () | Konstruktor |
public function HTMLLoader()| Laufzeitversionen: | AIR 1.0 |
Erstellt ein HTMLLoader-Objekt.
cancelLoad | () | Methode |
public function cancelLoad():void| Laufzeitversionen: | AIR 1.0 |
Bricht alle zurzeit stattfindenden Ladevorgänge ab.
createRootWindow | () | Methode |
public static function createRootWindow(visible:Boolean = true, windowInitOptions:NativeWindowInitOptions = null, scrollBarsVisible:Boolean = true, bounds:Rectangle = null):flash.html:HTMLLoader| Laufzeitversionen: | AIR 1.0 |
Erstellt ein neues NativeWindow-Objekt, das ein HTMLLoader-Objekt enthält. Laden Sie den HTML-Inhalt mit dem HTMLLoader-Objekt, dass von dieser Methode zurückgegeben wird.
Standardmäßig (wenn Sie beim Aufrufen dieser Methode keine Parameter festlegen), verwendet das neue Fenster das Standard-Systemchrom und enthält Bildlaufleisten zur Steuerung des Inhalts. Sie können die Parameter mit Werten belegen, um die Eigenschaften des neuen Fensters zu ändern.
Während das Fenster Inhalte lädt und Stylesheets anwendet, kann es zu kleineren Farbstörungen kommen. Damit solche Störungen nicht sichtbar sind, legen Sie den visible-Parameter auf false fest. Wenn das Fenster geladen wurde und seinen Inhalt angeordnet hat, machen Sie es sichtbar, indem Sie die window.nativeWindow.visible-Eigenschaft auf true setzen oder die window.nativeWindow.activate()-Methode aufrufen.
Parameter
visible:Boolean (default = true) | |
windowInitOptions:NativeWindowInitOptions (default = null)null werden NativeWindowInitOptions-Standardwerte verwendet.
| |
scrollBarsVisible:Boolean (default = true) | |
bounds:Rectangle (default = null)null ist, werden die Fenstergrenzen angegeben. Wenn eine der Eigenschaften x, y, width oder height den Wert NaN hat, behält die entsprechende Abmessung des Fensters den Standardwert.
|
flash.html:HTMLLoader — Ein neues HTMLLoader-Objekt, das sich auf der Bühne eines neuen NativeWindow-Objekts befindet.
|
getHistoryAt | () | Methode |
public function getHistoryAt(position:uint):flash.html:HTMLHistoryItem| Laufzeitversionen: | AIR 1.0 |
Gibt den Verlaufseintrag an der angegebenen Position zurück.
Parameter
position:uint — Die Position in der Verlaufsliste.
|
flash.html:HTMLHistoryItem — Ein URLRequest-Objekt für den Verlaufseintrag an der angegebenen Position.
|
Verwandte API-Elemente
historyBack | () | Methode |
public function historyBack():void| Laufzeitversionen: | AIR 1.0 |
Navigiert im Browserverlauf zurück, sofern möglich.
Der Aufruf dieser Methode des HTMLLoader-Objekts hat denselben Effekt wie der Aufruf der back()-Methode der window.history-Eigenschaft in JavaScript auf der HTML-Seite.
Diese Funktion löst keine Fehler aus.
Verwandte API-Elemente
historyForward | () | Methode |
public function historyForward():void| Laufzeitversionen: | AIR 1.0 |
Navigiert im Browserverlauf vorwärts, sofern möglich.
Der Aufruf dieser Methode des HTMLLoader-Objekts hat denselben Effekt wie der Aufruf der forward()-Methode der window.history-Eigenschaft in JavaScript auf der HTML-Seite.
Diese Funktion löst keine Fehler aus.
Verwandte API-Elemente
historyGo | () | Methode |
public function historyGo(steps:int):void| Laufzeitversionen: | AIR 1.0 |
Navigiert die angegebene Anzahl von Schritten im Browserverlauf. Navigiert vorwärts bei positiven Werten, zurück bei negativen. Navigation mit Null löst einen Neuladevorgang aus.
Diese Methode entspricht dem Aufruf der go()-Methode der window.history-Eigenschaft in JavaScript auf der HTML-Seite.
Diese Funktion löst keine Fehler aus.
Parameter
steps:int — Die Anzahl an Schritten, die in der Verlaufsliste weiter (positiv) oder rückwärts (negativ) navigiert werden soll.
|
Verwandte API-Elemente
load | () | Methode |
public function load(urlRequestToLoad:URLRequest):void| Laufzeitversionen: | AIR 1.0 |
Lädt das HTMLLoader-Objekt mit Daten von der Seite, die durch den urlRequestToLoad-Parameter angegeben wird. Der Aufruf dieser Methode stellt die loaded-Eigenschaft anfänglich auf false ein. Diese Methode initiiert einen Vorgang, der immer asynchron abgeschlossen wird.
Ein Aufruf dieser Methode führt direkt zum Abbruch aller ausstehenden früheren Ladevorgänge, die mit dieser Methode oder der loadString()-Methode eingeleitet wurden. Das complete-Ereignis für die früheren Ladevorgänge wird nie ausgelöst.
Es ist möglich, dass das complete-Ereignis nie ausgelöst wird. Dies ist der Fall, wenn HTML-Inhalt, der in das HTMLLoader-Objekt geladen wird, nie vollständig heruntergeladen wird. Dazu kann es kommen, wenn der HTML-Inhalt auf eine URL zu einem CGI-Skript verweist, das Inhalte unendlich oft wiederholt generiert.
Parameter
urlRequestToLoad:URLRequest — Das URLRequest-Objekt, das Informationen über die zu ladende URL enthält. Neben der zu ladenden URL enthält ein URLRequest-Objekt Eigenschaften, die die HTTP-Übertragungsmethode (GET oder POST) definieren, mit der Anforderung zu übertragende Daten und Anforderungsheader.
|
Verwandte API-Elemente
loadString | () | Methode |
public function loadString(htmlContent:String):void| Laufzeitversionen: | AIR 1.0 |
Lädt das HTMLLoader-Objekt mit dem HTML-Inhalt, der im HTML-String enthalten ist. Wenn die Wiedergabe des HTML im String abgeschlossen ist, wird das complete-Ereignis ausgelöst. Das complete-Ereignis wird immer asynchron ausgelöst.
Ein Aufruf dieser Methode führt direkt zum Abbruch aller ausstehenden früheren Ladevorgänge, die mit dieser Methode oder der load()-Methode eingeleitet wurden. Das complete-Ereignis für die früheren Ladevorgänge wird nie ausgelöst.
Wenn der im String angegebene HTML-Code keine Verweise auf externe Ressourcen enthält, wird der HTML-Code mit dieser Methode synchron dargestellt. Das complete-Ereignis wird jedoch trotzdem asynchron ausgelöst. Wenn die loaded-Eigenschaft dieser Klasse den Wert true hat, wird direkt nach einem Aufruf dieser Funktion der im htmlContent-Argument angegebene HTML-Inhalt synchron wiedergegeben.
Es ist möglich, dass das complete-Ereignis nie ausgelöst wird. Dies ist der Fall, wenn HTML-Inhalt, der in das HTMLLoader-Objekt geladen wird, nie vollständig heruntergeladen wird. Dazu kann es kommen, wenn der HTML-Inhalt auf eine URL zu einem CGI-Skript verweist, das Inhalte unendlich oft wiederholt generiert.
Inhalt, der über die loadString()-Methode geladen wurde, wird in der Sicherheitssandbox der Anwendung abgelegt, wenn die placeLoadStringContentInApplicationSandbox-Eigenschaft auf true eingestellt ist.
Parameter
htmlContent:String — Der String mit dem HTML-Inhalt, der in das HTMLLoader-Objekt geladen werden soll.
|
Verwandte API-Elemente
reload | () | Methode |
public function reload():void| Laufzeitversionen: | AIR 1.0 |
Lädt die Seite vom aktuellen Speicherort neu.
complete | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.COMPLETE| Laufzeitversionen: | AIR 1.0 |
Gibt an, dass der letzte Ladevorgang, der von der loadString- oder load-Methode angefordert wurde, abgeschlossen ist. Das Ereignis wird ausgelöst, nachdem das JavaScript-load-Ereignis für das HTML-DOM im HTMLLoader-Objekt ausgelöst wurde. Das Ereignis wird immer asynchron ausgelöst. Die Ereignisprozedur für dieses Ereignis kann jede Methode aufrufen oder auf jede Eigenschaft des HTMLLoader-Objekts zugreifen.
Event.COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines complete-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Netzwerkobjekt, dessen Ladevorgang beendet ist. |
Verwandte API-Elemente
htmlBoundsChange | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.HTML_BOUNDS_CHANGE| Laufzeitversionen: | AIR 1.0 |
Gibt an, dass mindestens eine der Eigenschaften contentWidth und contentHeight des HTMLLoader-Objekts geändert wurde. Dies kann zum Beispiel aus einem neuen Bild oder anderen geladenen Inhalten resultieren. Ereignisprozeduren können beliebige Methoden aufrufen und auf jede Eigenschaft des HTMLLoader-Objekts zugreifen.
Das HTMLLoader-Objekt kann dieses Ereignis jederzeit nach dem Beginn eines Ladevorgangs auslösen, auch nachdem das complete-Ereignis bereits vom Objekt ausgelöst wurde.
Event.HTML_BOUNDS_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines htmlBoundsChange-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das HTMLLoader-Objekt. |
target | Das HTMLLoader-Objekt. |
Verwandte API-Elemente
htmlDOMInitialize | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.HTML_DOM_INITIALIZE| Laufzeitversionen: | AIR 1.0 |
Gibt an, dass das HTML-DOM als Antwort auf einen Ladevorgang erstellt wurde. Die load()- und loadString()-Methoden des HTMLLoader-Objekts lösen eine Ausnahme aus, während dieses Ereignis ausgelöst wird. Jede Eigenschaft oder Methode eines beliebigen JavaScript-Objekts, auf das von der window-Eigenschaft des HTMLLoader-Objekts zugegriffen werden kann, das die URL steuert, die in das HTMLLoader-Objekt geladen wird, löst eine Ausnahme aus, wenn sie festgelegt oder aufgerufen wird, während dieses Ereignis ausgelöst wird. Zum Beispiel verursacht das Einstellen der window.location durch Einstellen der window-Eigenschaft des HTMLLoader-Objekts eine JavaScript-Ausnahme.
Event.HTML_DOM_INITIALIZE-Konstante definiert den Wert der type-Eigenschaft eines htmlDOMInitialize-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das HTMLLoader-Objekt. |
target | Das HTMLLoader-Objekt. |
Verwandte API-Elemente
htmlRender | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.HTML_RENDER| Laufzeitversionen: | AIR 1.0 |
Gibt an, dass die Darstellung des Inhalts im HTMLLoader-Objekt auf dem neuesten Stand ist. Dieses Ereignis kann ziemlich häufig ausgelöst werden, wenn Wiedergabeänderungen am HTML-Inhalt vorgenommen werden. Dieses Ereignis wird zum Beispiel ausgelöst, wenn neuer Inhalt angezeigt wird, nachdem der Benutzer auf einen Hyperlink geklickt hat oder wenn JavaScript auf der Seite HTML wiedergibt. Ereignisprozeduren können beliebige Methoden aufrufen und auf jede Eigenschaft des HTMLLoader-Objekts zugreifen.
Prozeduren für dieses Ereignis sollten die contentWidth- und contentHeight-Eigenschaften des HTMLLoader-Objekts überprüfen, um Bildlaufleisten, die mit dem HTMLLoader-Objekt verknüpft sind, zu aktualisieren.
Das HTMLLoader-Objekt kann dieses Ereignis jederzeit nach dem Beginn eines Ladevorgangs auslösen, auch nachdem das complete-Ereignis bereits vom Objekt ausgelöst wurde.
Event.HTML_RENDER-Konstante definiert den Wert der type-Eigenschaft eines htmlRender-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das HTMLLoader-Objekt. |
target | Das HTMLLoader-Objekt. |
locationChange | Ereignis |
flash.events.LocationChangeEventEigenschaft LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGE| Laufzeitversionen: | AIR 2.7 |
Gibt an, dass die location-Eigenschaft des HTMLLoader-Objekts geändert wurde. Die Ereignisprozedur für dieses Ereignis kann jede Methode aufrufen oder auf jede Eigenschaft des HTMLLoader-Objekts zugreifen.
Ein locationChange-Ereignis des Typs LocationChangeEvent wird vom HTMLLoader-Objekt in Anwendungen abgesetzt, die den AIR-Namespace 2.7 und höher verwenden. In früheren AIR-Versionen ist das abgesetzte Ereignisobjekt eine Instanz der Event-Klasse.
Verwandte API-Elemente
locationChange | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.LOCATION_CHANGE| Laufzeitversionen: | AIR 1.0 |
Gibt an, dass die location-Eigenschaft des HTMLLoader-Objekts geändert wurde. Die Ereignisprozedur für dieses Ereignis kann jede Methode aufrufen oder auf jede Eigenschaft des HTMLLoader-Objekts zugreifen.
Ein locationChange-Ereignis des Typs Event wird vom HTMLLoader-Objekt in Anwendungen abgesetzt, die einen AIR-Namespace vor 2.7 verwenden. Ab AIR 2.7 ist das Ereignisobjekt eine Instanz der LocationChangeEvent-Klasse, die eine zusätzliche location-Eigenschaft bereitstellt, die auf die URL der neuen Seite eingestellt ist.
Event.LOCATION_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines locationChange-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das HTMLLoader-Objekt. |
target | Das HTMLLoader-Objekt. |
Verwandte API-Elemente
locationChanging | Ereignis |
flash.events.LocationChangeEventEigenschaft LocationChangeEvent.type =
flash.events.LocationChangeEvent.LOCATION_CHANGING| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 2.7 |
Zeigt an, dass sich die location-Eigenschaft des HTMLLoader-Objekts gleich ändert.
Ein locationChanging-Ereignis wird nur dann abgesetzt, wenn die Positionsänderung durch eine Benutzerinteraktion, zum Beispiel das Klicken auf einen Hyperlink, oder durch Code, der innerhalb des HTMLLoader ausgeführt wird, zum Beispiel eine clientseitige Umleitung, ausgelöst wurde. Standardmäßig wird die neue Position in diesem HTMLLoader-Objekt angezeigt. Sie können die preventDefault()-Methode des Ereignisobjekts aufrufen, um das Standardverhalten zu verhindern. Sie könnten zum Beispiel die flash.net.navigateToURL()-Funktion verwenden, um die Seite im Systembrowser basierend auf der location-Eigenschaft des Ereignisobjekts zu öffnen..
Es wird kein locationChanging()-Ereignis abgesetzt, wenn Sie die folgenden Methoden aufrufen:
- load()
- loadString()
- reload()
- historyBack()
- historyForward()
- historyGo()
Dieses Ereignis wird des Weiteren ebenfalls nicht abgesetzt, wenn die navigateInSystemBrowser-Eigenschaft den Wert true hat und die Zielseite im Systembrowser geöffnet wird, da sich in diesem Fall die HTMLLoader-Position nicht ändert.
LOCATION_CHANGING-Konstante definiert den Wert der type-Eigenschaft des LocationChangeEvent-Objekts, das vor einer Änderung der Seitenposition abgesetzt wird.
Beispiel ( Verwendung dieses Beispiels )
package{
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class LocationChanging extends Sprite
{
var htmlLoader:HTMLLoader = new HTMLLoader();
public function LocationChanging()
{
htmlLoader.width = stage.stageWidth;
htmlLoader.height = stage.stageHeight;
htmlLoader.addEventListener( LocationChangeEvent.LOCATION_CHANGING, onLocationChanging );
htmlLoader.load( new URLRequest( "http://www.adobe.com" ) );
this.addChild( htmlLoader );
}
private function onLocationChanging( event:LocationChangeEvent ):void
{
trace( "Location changing: " + event.location );
if ( event.location.indexOf( "http://www.adobe.com" ) < 0 )
{
event.preventDefault();
}
}
}
}
scroll | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.SCROLL| Laufzeitversionen: | AIR 1.0 |
Gibt an, dass die scrollH- oder scrollV-Eigenschaft vom HTMLLoader-Objekt geändert wurde. Das HTMLLoader-Objekt löst dieses Ereignis aus, wenn im HTMLLoader-Objekt ausgeführtes JavaScript die scrollte()-Methode des window-Objekts aufruft und die gewünschte Position noch nicht sichtbar ist. Das Ereignis wird nicht ausgelöst, wenn ActionScript-Code die scrollH- oder scrollV-Eigenschaft ändert. Ereignisprozeduren können beliebige Methoden aufrufen und auf jede Eigenschaft des HTMLLoader-Objekts zugreifen.
Ereignisprozeduren für dieses Ereignis sollten die scrollH- und scrollV-Eigenschaften überprüfen, um ggf. mit dem HTMLLoader-Objekt verknüpfte Bildlaufleisten zu aktualisieren.
Das HTMLLoader-Objekt kann dieses Ereignis jederzeit nach dem Beginn eines Ladevorgangs auslösen, auch nachdem das complete-Ereignis bereits vom Objekt ausgelöst wurde.
Event.SCROLL-Konstante definiert den Wert der type-Eigenschaft eines scroll-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das TextField-Objekt, für das ein Bildlauf durchgeführt wurde. Die target-Eigenschaft entspricht nicht immer dem Objekt in der Anzeigeliste, das den Ereignis-Listener registriert hat. Mit der Eigenschaft currentTarget können Sie auf das Objekt in der Anzeigeliste zugreifen, das das Ereignis derzeit verarbeitet. |
uncaughtScriptException | Ereignis |
flash.events.HTMLUncaughtScriptExceptionEventEigenschaft HTMLUncaughtScriptExceptionEvent.type =
flash.events.HTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION| Laufzeitversionen: | AIR 1.0 |
Gibt an, dass im HTMLLoader-Objekt eine nicht erfasste JavaScript-Ausnahme aufgetreten ist. Ereignisprozeduren können beliebige Methoden aufrufen und auf jede Eigenschaft des HTMLLoader-Objekts zugreifen. Das Ereignis kann abgebrochen werden. Das Standardverhalten beim Ausführen im AIR Debug Launcher ist das Senden des JavaScript-Stacks an die Trace-Ausgabe.
Die KonstanteHTMLUncaughtScriptExceptionEvent.UNCAUGHT_SCRIPT_EXCEPTION definiert den Wert der type-Eigenschaft eines uncaughtScriptException-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
exceptionValue | Das Ergebnis der Evaluierung des Ausdrucks in der throw-Anweisung, der zu der nicht erfassten Ausnahme geführt hat. |
stackTrace | Ein Array von Objekten, die den Stack-Trace zu dem Zeitpunkt repräsentieren, an dem die throw-Anweisung, die zu der nicht erfassten Ausnahme führte, ausgeführt wurde. |
target | Das HTMLLoader-Objekt. |
Verwandte API-Elemente
package {
import flash.display.Sprite;
import flash.html.HTMLLoader;
import flash.net.URLRequest;
public class HTMLLoaderExample extends Sprite
{
public function HTMLLoaderExample()
{
var html:HTMLLoader = new HTMLLoader();
var urlReq:URLRequest = new URLRequest("http://www.adobe.com/");
html.width = stage.stageWidth;
html.height = stage.stageHeight;
html.load(urlReq);
addChild(html);
}
}
}
Tue Jun 12 2018, 10:04 AM Z