HTMLLoader

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

Die HTMLLoader-Klasse definiert einen Anzeigeobjekttyp, der ein Container für HTML-Inhalte ist.

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.

Beispiele anzeigen

Öffentliche Eigenschaften

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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		HTMLLoader() Erstellt ein HTMLLoader-Objekt.	HTMLLoader
		addChild(child:DisplayObject):DisplayObject Fügt dieser DisplayObjectContainer-Instanz eine untergeordnete DisplayObject-Instanz hinzu.	DisplayObjectContainer
		addChildAt(child:DisplayObject, index:int):DisplayObject 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
		areInaccessibleObjectsUnderPoint(point:Point):Boolean 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
		cancelLoad():void Bricht alle zurzeit stattfindenden Ladevorgänge ab.	HTMLLoader
		contains(child:DisplayObject):Boolean 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
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getBounds(targetCoordinateSpace:DisplayObject):Rectangle Gibt ein Rechteck zurück, das den Bereich des Anzeigeobjekts in Bezug auf das Koordinatensystem des targetCoordinateSpace-Objekts definiert.	DisplayObject
		getChildAt(index:int):DisplayObject Gibt die untergeordnete Anzeigeobjektinstanz zurück, die sich an der angegebenen Indexposition befindet.	DisplayObjectContainer
		getChildByName(name:String):DisplayObject Gibt das untergeordnete Anzeigeobjekt für den angegebenen Namen zurück.	DisplayObjectContainer
		getChildIndex(child:DisplayObject):int Gibt die Indexposition einer untergeordneten DisplayObject-Instanz zurück.	DisplayObjectContainer
		getHistoryAt(position:uint):flash.html:HTMLHistoryItem Gibt den Verlaufseintrag an der angegebenen Position zurück.	HTMLLoader
		getObjectsUnderPoint(point:Point):Array 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
		getRect(targetCoordinateSpace:DisplayObject):Rectangle 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
		globalToLocal(point:Point):Point Konvertiert das point-Objekt von den (globalen) Bühnenkoordinaten in die (lokalen) Koordinaten des Anzeigeobjekts.	DisplayObject
		globalToLocal3D(point:Point):Vector3D Konvertiert einen zweidimensionale Punkt von den (globalen) Bühnenkoordinaten in die dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts.	DisplayObject
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		historyBack():void Navigiert im Browserverlauf zurück, sofern möglich.	HTMLLoader
		historyForward():void Navigiert im Browserverlauf vorwärts, sofern möglich.	HTMLLoader
		historyGo(steps:int):void Navigiert die angegebene Anzahl von Schritten im Browserverlauf.	HTMLLoader
		hitTestObject(obj:DisplayObject):Boolean Untersucht den Begrenzungsrahmen des Anzeigeobjekts, um festzustellen, ob er sich mit dem Begrenzungsrahmen des obj-Anzeigeobjekts überschneidet.	DisplayObject
		hitTestPoint(x:Number, y:Number, shapeFlag:Boolean = false):Boolean Wertet das Anzeigeobjekt aus, um festzustellen, ob es den durch die Parameter „x“ und „y“ festgelegten Punkt überdeckt oder schneidet.	DisplayObject
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		load(urlRequestToLoad:URLRequest):void Lädt das HTMLLoader-Objekt mit Daten von der Seite, die durch den urlRequestToLoad-Parameter angegeben wird.	HTMLLoader
		loadString(htmlContent:String):void Lädt das HTMLLoader-Objekt mit dem HTML-Inhalt, der im HTML-String enthalten ist.	HTMLLoader
		local3DToGlobal(point3d:Vector3D):Point Konvertiert einen dreidimensionalen Punkt der dreidimensionalen (lokalen) Koordinaten des Anzeigeobjekts in einen zweidimensionalen Punkt der (globalen) Bühnenkoordinaten.	DisplayObject
		localToGlobal(point:Point):Point Konvertiert das point-Objekt von den (lokalen) Koordinaten des Anzeigeobjekts in die (globalen) Bühnenkoordinaten.	DisplayObject
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		reload():void Lädt die Seite vom aktuellen Speicherort neu.	HTMLLoader
		removeChild(child:DisplayObject):DisplayObject Entfernt die angegebene untergeordnete DisplayObject-Instanz aus der Child-Liste der DisplayObjectContainer-Instanz.	DisplayObjectContainer
		removeChildAt(index:int):DisplayObject Entfernt ein untergeordnetes Anzeigeobjekt aus der angegebenen Indexposition in der Child-Liste des Anzeigeobjekt-Containers.	DisplayObjectContainer
		removeChildren(beginIndex:int = 0, endIndex:int = 0x7fffffff):void Entfernt alle untergeordneten DisplayObject-Instanzen aus der Liste der untergeordneten Elemente der DisplayObjectContainer-Instanz.	DisplayObjectContainer
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		requestSoftKeyboard():Boolean Blendet eine virtuelle Tastatur ein.	InteractiveObject
		setChildIndex(child:DisplayObject, index:int):void Ändert die Position eines vorhandenen untergeordneten Objekts im Anzeigeobjekt-Container.	DisplayObjectContainer
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		startDrag(lockCenter:Boolean = false, bounds:Rectangle = null):void Ermöglicht es Benutzern, das angegebene Sprite mit einer Ziehoperation zu verschieben.	Sprite
		startTouchDrag(touchPointID:int, lockCenter:Boolean = false, bounds:Rectangle = null):void Ermöglicht dem Benutzer das Ziehen des angegebenen Sprites auf einem berührungsempfindlichen Gerät.	Sprite
		stopAllMovieClips():void Stoppt rekursiv die Ausführung von allen Movieclips, die auf diesem Objekt gerootet sind.	DisplayObjectContainer
		stopDrag():void Beendet die startDrag()-Methode.	Sprite
		stopTouchDrag(touchPointID:int):void Beendet die startTouchDrag()-Methode zur Verwendung mit berührungsempfindlichen Geräten.	Sprite
		swapChildren(child1:DisplayObject, child2:DisplayObject):void Kehrt die z-Reihenfolge (von vorne nach hinten) der beiden angegebenen untergeordneten Objekte um.	DisplayObjectContainer
		swapChildrenAt(index1:int, index2:int):void Kehrt die z-Reihenfolge (von vorne nach hinten) der untergeordneten Objekte an den beiden angegebenen Indexpositionen in der Child-Liste um.	DisplayObjectContainer
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
added	Wird ausgelöst, wenn ein Objekt der Anzeigeliste hinzugefügt wird.	DisplayObject
addedToStage	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
clear	Wird ausgelöst, wenn der Benutzer aus dem Kontextmenü die Option „Löschen“ wählt.	InteractiveObject
click	Wird ausgelöst, wenn ein Benutzer die Haupttaste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und wieder loslässt.	InteractiveObject
complete	Gibt an, dass der letzte Ladevorgang, der von der loadString- oder der load-Methode angefordert wurde, abgeschlossen ist.	HTMLLoader
contextMenu	Wird ausgelöst, wenn der Benutzer das Kontextmenü, das mit diesem interaktiven Objekt verknüpft ist, in einer AIR-Anwendung einblendet.	InteractiveObject
copy	Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Kopieren“ aktiviert oder im Kontextmenü des Texts „Kopieren“ wählt.	InteractiveObject
cut	Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Ausschneiden“ aktiviert oder im Kontextmenü des Texts „Ausschneiden“ wählt.	InteractiveObject
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
doubleClick	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
enterFrame	[broadcast event] Wird ausgelöst, wenn der Abspielkopf ein neues Bild erreicht.	DisplayObject
exitFrame	[broadcast event] Wird ausgelöst, wenn der Abspielkopf das aktuelle Bild verlässt.	DisplayObject
focusIn	Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus erhalten hat.	InteractiveObject
focusOut	Wird ausgelöst, nachdem ein Anzeigeobjekt den Fokus verloren hat.	InteractiveObject
frameConstructed	[broadcast event] Wird ausgelöst, nachdem die Konstruktoren von Bildanzeigeobjekten ausgeführt wurden, bevor Bildskripten ausgeführt wurden.	DisplayObject
gestureDirectionalTap	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
gestureLongPress	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
gesturePan	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
gestureRotate	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
gestureSwipe	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
gestureTap	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
gestureZoom	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
htmlBoundsChange	Gibt an, dass mindestens eine der Eigenschaften contentWidth und contentHeight eines HTMLLoader-Objekts geändert wurde.	HTMLLoader
htmlDOMInitialize	Gibt an, dass das HTML-DOM als Antwort auf einen Ladevorgang erstellt wurde.	HTMLLoader
htmlRender	Gibt an, dass die Darstellung des Inhalts im HTMLLoader-Objekt auf dem neuesten Stand ist.	HTMLLoader
imeStartComposition	Dieses Ereignis wird an jede Client-Anwendung abgesetzt, die die Inline-Eingabe mit einem IME unterstützt	InteractiveObject
keyDown	Wird ausgelöst, wenn der Benutzer eine Taste drückt.	InteractiveObject
keyFocusChange	Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe der Tastatur zu ändern.	InteractiveObject
keyUp	Wird ausgelöst, wenn der Benutzer eine Taste loslässt.	InteractiveObject
locationChange	Gibt an, dass die location-Eigenschaft des HTMLLoader-Objekts geändert wurde.	HTMLLoader
locationChange	Gibt an, dass die location-Eigenschaft des HTMLLoader-Objekts geändert wurde.	HTMLLoader
locationChanging	Zeigt an, dass sich die location-Eigenschaft des HTMLLoader-Objekts gleich ändert.	HTMLLoader
middleClick	Wird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt.	InteractiveObject
middleMouseDown	Wird ausgelöst, wenn der Benutzer die mittlere Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt.	InteractiveObject
middleMouseUp	Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt.	InteractiveObject
mouseDown	Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt.	InteractiveObject
mouseFocusChange	Wird ausgelöst, wenn der Benutzer versucht, den Fokus mithilfe eines Zeigegeräts zu ändern.	InteractiveObject
mouseMove	Wird ausgelöst, wenn der Benutzer das Zeigegerät bewegt, während es sich auf einer InteractiveObject-Instanz befindet.	InteractiveObject
mouseOut	Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt.	InteractiveObject
mouseOver	Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt.	InteractiveObject
mouseUp	Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt.	InteractiveObject
mouseWheel	Wird ausgelöst, wenn das Mausrad über einer InteractiveObject-Instanz gedreht wird.	InteractiveObject
nativeDragComplete	Wird vom InteractiveObject-Ziehinitiator ausgelöst, wenn der Benutzer die Ziehbewegung beendet.	InteractiveObject
nativeDragDrop	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
nativeDragEnter	Wird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung in ihre Begrenzungen eintritt.	InteractiveObject
nativeDragExit	Wird von einer InteractiveObject-Instanz ausgelöst, wenn eine Ziehbewegung ihre Begrenzungen verlässt.	InteractiveObject
nativeDragOver	Wird von einer InteractiveObject-Instanz kontinuierlich ausgelöst, während eine Ziehbewegung innerhalb ihrer Begrenzungen verbleibt.	InteractiveObject
nativeDragStart	Wird am Anfang eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist.	InteractiveObject
nativeDragUpdate	Wird während eines Ziehvorgangs von der InteractiveObject-Instanz ausgelöst, die als Ziehinitiator im DragManager.doDrag()-Aufruf festgelegt ist.	InteractiveObject
paste	Wird abgesetzt, wenn der Benutzer die plattformspezifische Tastenkombination für „Einfügen“ aktiviert oder im Kontextmenü des Texts „Einfügen“ wählt.	InteractiveObject
proximityBegin	Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift unter den Schwellenwert für die Abstandserkennung des Bildschirms senkt.	InteractiveObject
proximityEnd	Wird abgesetzt, wenn der Benutzer einen aktiven Eingabestift über den Schwellenwert für die Abstandserkennung des Bildschirms anhebt.	InteractiveObject
proximityMove	Wird abgesetzt, wenn der Benutzer den aktiven Eingabestift über den Bildschirm bewegt, während er innerhalb des Schwellenwerts der Abstandserkennung bleibt.	InteractiveObject
proximityOut	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
proximityOver	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
proximityRollOut	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
proximityRollOver	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
releaseOutside	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
removed	Wird ausgelöst, wenn ein Objekt aus der Anzeigeliste entfernt werden soll.	DisplayObject
removedFromStage	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
render	[broadcast event] Wird ausgelöst, wenn die Anzeigeliste kurz davor steht, aktualisiert und neu gezeichnet zu werden.	DisplayObject
rightClick	Wird ausgelöst, wenn der Benutzer die rechte Taste des Zeigegeräts über derselben InteractiveObject-Instanz drückt und loslässt.	InteractiveObject
rightMouseDown	Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz drückt.	InteractiveObject
rightMouseUp	Wird ausgelöst, wenn der Benutzer die Taste des Zeigegeräts über einer InteractiveObject-Instanz loslässt.	InteractiveObject
rollOut	Wird ausgelöst, wenn der Benutzer das Zeigegerät von einer InteractiveObject-Instanz wegbewegt.	InteractiveObject
rollOver	Wird ausgelöst, wenn der Benutzer das Zeigegerät auf eine InteractiveObject-Instanz bewegt.	InteractiveObject
scroll	Gibt an, dass die scrollH- oder scrollV-Eigenschaft vom HTMLLoader-Objekt geändert wurde.	HTMLLoader
selectAll	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
softKeyboardActivate	Wird sofort nach dem Einblenden der Softwaretastatur abgesetzt.	InteractiveObject
softKeyboardActivating	Wird direkt vor dem Einblenden der Softwaretastatur abgesetzt.	InteractiveObject
softKeyboardDeactivate	Wird sofort nach dem Ausblenden der Softwaretastatur abgesetzt.	InteractiveObject
tabChildrenChange	Wird ausgelöst, wenn sich der Wert des tabChildren-Flags des Objekts ändert.	InteractiveObject
tabEnabledChange	Wird ausgelöst, wenn sich das tabEnabled-Flag des Objekts ändert.	InteractiveObject
tabIndexChange	Wird ausgelöst, wenn sich der Wert der tabIndex-Eigenschaft des Objekts ändert.	InteractiveObject
textInput	Wird ausgelöst, wenn ein Benutzer ein oder mehrere Textzeichen eingibt.	InteractiveObject
touchBegin	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
touchEnd	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
touchMove	Wird abgesetzt, wenn der Benutzer das Gerät berührt, und zwar kontinuierlich, bis der Kontaktpunkt entfernt wird.	InteractiveObject
touchOut	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
touchOver	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
touchRollOut	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
touchRollOver	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
touchTap	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
uncaughtScriptException	Gibt an, dass im HTMLLoader-Objekt eine nicht erfasste JavaScript-Ausnahme aufgetreten ist.	HTMLLoader

Eigenschaftendetails

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):void

Verwandte API-Elemente

flash.net.URLRequest.authenticate
flash.net.URLRequestDefaults.authenticate

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):void

Verwandte API-Elemente

flash.net.URLRequestDefaults.cacheResponse

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

hasFocusableContent:Boolean [schreibgeschützt]

Laufzeitversionen:

AIR 1.0

Gibt an, ob Inhalt im HTMLLoader-Objekt den Fokus erhalten kann.

Implementierung
public function get hasFocusableContent():Boolean

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():uint

Verwandte 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):void

Verwandte API-Elemente

getHistoryAt()
historyBack()
historyGo()
historyForward()
historyLength

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):void

Verwandte API-Elemente

HTMLHost-Klasse

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):void

Verwandte API-Elemente

URLRequestDefaults.idleTimeout

isSupported

Eigenschaft

isSupported:Boolean [schreibgeschützt]

Laufzeitversionen:

AIR 2

Gibt an, ob die HTMLLoader-Klasse vom Clientsystem unterstützt wird.

Implementierung
public static function get isSupported():Boolean

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

location:String [schreibgeschützt]

Laufzeitversionen:

AIR 1.0

Die URL für den in das HTMLLoader-Objekt geladenen Inhalt.

Implementierung
public function get location():String

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):void

Verwandte API-Elemente

flash.net.URLRequest.manageCookies
flash.net.URLRequestDefaults.manageCookies

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 `pdfCapability`-Eigenschaft `PDFCapability.STATUS_OK` ist, wenn die AIR-Anwendung versucht PDF-Inhalte zu laden, zeigt die ältere Version von Acrobat oder Adobe Reader eine Warnung an (und die AIR-Laufzeitumgebung zeigt keine Fehlermeldung an). Falls diese Situation für Ihre Benutzer entstehen kann, weisen Sie sie an, Acrobat oder Adobe Reader zu schließen, während Ihre Anwendung ausgeführt wird. Zeigen Sie diese Anweisungen ggf. an, wenn der PDF-Inhalt nicht innerhalb eines vertretbaren Zeitraums angezeigt wird.
`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():int

Verwandte API-Elemente

HTMLPDFCapability-Klasse

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):void

Verwandte API-Elemente

loadString()

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):void

Auslöser

SecurityError — wenn das ApplicationDomain-Objekt nicht aus der Sicherheitsdomäne des Aufrufers stammt.

Verwandte API-Elemente

flash.system.ApplicationDomain
flash.system.SecurityDomain

scrollH

Eigenschaft

scrollH:Number

Laufzeitversionen:

AIR 1.0

Die horizontale Bildlaufposition des HTML-Inhalts innerhalb des HTMLLoader-Objekts.

Implementierung
public function get scrollH():Number
public function set scrollH(value:Number):void

scrollV

Eigenschaft

scrollV:Number

Laufzeitversionen:

AIR 1.0

Die vertikale Bildlaufposition des HTML-Inhalts innerhalb des HTMLLoader-Objekts.

Implementierung
public function get scrollV():Number
public function set scrollV(value:Number):void

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():int

Verwandte API-Elemente

HTMLSWFCapability-Klasse

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):void

Verwandte 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):void

Verwandte API-Elemente

textEncodingFallback

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):void

Verwandte API-Elemente

flash.net.URLRequest.useCache
flash.net.URLRequestDefaults.useCache

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):void

Verwandte API-Elemente

flash.net.URLRequest.userAgent
flash.net.URLRequestDefaults.userAgent

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

window:Object [schreibgeschützt]

Laufzeitversionen:

AIR 1.0

Das globale JavaScript-Objekt für den Inhalt, der in das HTML-Steuerelement geladen wird.

Implementierung
public function get window():Object

Konstruktordetails

()

Konstruktor

public function HTMLLoader()

Laufzeitversionen:

AIR 1.0

Erstellt ein HTMLLoader-Objekt.

Methodendetails

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`) — Gibt an, ob das Fenster sichtbar ist.

	`windowInitOptions:NativeWindowInitOptions` (default = `null`) — Gibt Fensterinitialisierungsoptionen an; mit dem Wert `null` werden `NativeWindowInitOptions`-Standardwerte verwendet.

	`scrollBarsVisible:Boolean` (default = `true`) — Gibt an, ob das Fenster Bildlaufleisten enthält.

	`bounds:Rectangle` (default = `null`) — Wenn der Wert nicht `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.

Rückgabewerte

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.

Rückgabewerte

flash.html:HTMLHistoryItem — Ein URLRequest-Objekt für den Verlaufseintrag an der angegebenen Position.

Verwandte API-Elemente

historyPosition

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

historyPosition

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

historyPosition

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

historyPosition

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

flash.net.URLRequest

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.

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

placeLoadStringContentInApplicationSandbox

reload

()

Methode

public function reload():void

Laufzeitversionen:

AIR 1.0

Lädt die Seite vom aktuellen Speicherort neu.

Ereignisdetails

complete

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft 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.

Die 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

loadString()
load()

htmlBoundsChange

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft 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.

Die 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

contentWidth
contentHeight

htmlDOMInitialize

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft 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.

Die 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

loadString()
load()

htmlRender

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft 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.

Die 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

Ereignisobjekttyp: flash.events.LocationChangeEvent
Eigenschaft 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.

Wird nach jeder Positionsänderung abgesetzt.

Verwandte API-Elemente

loadString()
load()

locationChange

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft Event.type = flash.events.Event.LOCATION_CHANGE

Laufzeitversionen:

AIR 1.0

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.

Die 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

loadString()
load()

locationChanging

Ereignis

Ereignisobjekttyp: flash.events.LocationChangeEvent
Eigenschaft 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.

Die LOCATION_CHANGING-Konstante definiert den Wert der type-Eigenschaft des LocationChangeEvent-Objekts, das vor einer Änderung der Seitenposition abgesetzt wird.
Beispiel ( Verwendung dieses Beispiels )

Der folgende Code initialisiert ein HTMLLoader-Objekt, konfiguriert Breite und Höhe, lädt die URL http://www.adobe.com und fügt das Objekt zur Anzeigeliste hinzu. Wenn der Benutzer (oder JavaScript auf der Seite) versucht, zu einer URL zu navigieren, die nicht mit der Basis-URL beginnt, wird die Navigation verhindert:

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

Ereignisobjekttyp: flash.events.Event
Eigenschaft 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.

Die 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

Ereignisobjekttyp: flash.events.HTMLUncaughtScriptExceptionEvent
Eigenschaft 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 Konstante HTMLUncaughtScriptExceptionEvent.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

loadString()
load()

Beispiele Verwendung dieses Beispiels

HTMLLoader.1.as

Der folgende Code initialisiert ein HTMLLoader-Objekt, konfiguriert Breite und Höhe, lädt die URL http://www.adobe.com und fügt das Objekt zur Anzeigeliste hinzu:

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);
        }
    }
}

Rechtliche Hinweise | Onlinedatenschutzerklärung

HTMLLoader - AS3

Paketex

Sprachelemente

Anhänge

Paket flash.html

authenticate

cacheResponse

contentHeight

contentWidth

hasFocusableContent

height

historyLength

historyPosition

htmlHost

idleTimeout

isSupported

loaded

location

manageCookies

navigateInSystemBrowser

paintsDefaultBackground

pdfCapability

placeLoadStringContentInApplicationSandbox

runtimeApplicationDomain

scrollH

scrollV

swfCapability

textEncodingFallback

textEncodingOverride

useCache

userAgent

width

window

HTMLLoader

cancelLoad

createRootWindow

getHistoryAt

historyBack

historyForward

historyGo

load

loadString

reload

complete

htmlBoundsChange

htmlDOMInitialize

htmlRender

locationChange

locationChange

locationChanging

scroll

uncaughtScriptException