BrowserInvokeEvent

Paket	flash.events
Klasse	public class BrowserInvokeEvent
Vererbung	BrowserInvokeEvent Event Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Das NativeApplication-Objekt einer AIR-Anwendung löst ein browserInvoke-Ereignis aus, wenn die Anwendung durch eine SWF-Datei im Browser mit der Browseraufruffunktion aufgerufen wurde. Das NativeApplication-Objekt löst ein browserInvoke-Ereignis auch dann aus, wenn ein Benutzer die nahtlose Installationsfunktion im Browser instanziiert und die SWF-Datei im Browser ein Array an den arguments-Parameter der launchApplication()-Methode der „air.swf“-Datei übergibt. (Weitere Informationen finden Sie unter „Verteilen, Installieren und Ausführen von AIR-Anwendungen“ im AIR-Entwicklerhandbuch.)

Der Aufruf durch den Browser ist nur dann zulässig, wenn in der Anwendungsdeskriptordatei einer Anwendung Folgendes angegeben ist:

<allowBrowserInvocation>true</allowBrowserInvocation>

Wenn die Anwendung nicht ausgeführt wird, löst das NativeApplication-Objekt ein InvokeEvent-Ereignis und ein browserInvoke-Ereignis aus, wenn der Aufruf über den Browser erfolgt. Andernfalls, wenn die Anwendung bereits ausgeführt wird, löst das NativeApplication-Objekt nur ein browserInvoke-Ereignis aus, wenn der Aufruf über den Browser erfolgt.

Wenn die Anwendung als Ergebnis einer nahtlosen Installation vom Browser aufgerufen wird (wenn der Benutzer sich für den sofortigen Start nach der Installation entschieden hat), löst das NativeApplication-Objekt ein BrowserInvoke-Ereignis nur dann aus, wenn Argumente übergeben werden (über die SWF-Datei im Browser, die ein Array an den arguments-Parameter der installApplication()-Methode der „air.swf“-Datei übergibt). Weitere Informationen finden Sie unter „Verteilen, Installieren und Ausführen von AIR-Anwendungen“ im AIR-Entwicklerhandbuch.

Wie auch das invokeEvent-Ereignis werden browserInvokeEvent-Ereignisse vom NativeApplication-Objekt (NativeApplication.nativeApplication) ausgelöst. Um browserInvoke-Ereignisse zu erhalten, rufen Sie die addEventListener()-Methode des NativeApplication-Objekts auf. Wenn ein Ereignis-Listener für ein browserInvoke-Ereignis registriert wird, empfängt er auch alle browserInvoke-Ereignisse, die vor der Registrierung aufgetreten sind. Diese werden nach der Rückgabe des Aufrufs von addEventListener() ausgelöst, jedoch nicht unbedingt vor anderen browserInvoke-Ereignissen, die möglicherweise nach der Registrierung empfangen wurden. Auf diese Weise können Sie browserInvoke-Ereignisse verarbeiten, die aufgetreten sind, bevor Ihr Initialisierungscode ausgeführt wurde (zum Beispiel wenn die Anwendung ursprünglich über den Browser aufgerufen wurde). Denken Sie daran, dass beim Hinzufügen eines Ereignis-Listeners zu einem späteren Zeitpunkt während der Ausführung (nach der Initialisierung der Anwendung) dieser alle browserInvoke-Ereignisse empfängt, die seit dem Starten der Anwendung aufgetreten sind.

Verwandte API-Elemente

flash.events.InvokeEvent
flash.desktop.NativeApplication

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		arguments : Array [schreibgeschützt] Ein Array von Argumenten (Strings), die an die Anwendung zu übergeben sind.	BrowserInvokeEvent
		bubbles : Boolean [schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.	Event
		cancelable : Boolean [schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.	Event
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		currentTarget : Object [schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.	Event
		eventPhase : uint [schreibgeschützt] Die aktuelle Phase im Ereignisablauf.	Event
		isHTTPS : Boolean [schreibgeschützt] Ob der Browserinhalt das HTTPS-URL-Schema verwendet (true) oder nicht (false).	BrowserInvokeEvent
		isUserEvent : Boolean [schreibgeschützt] Ob der Browseraufruf in einem Benutzerereignis resultiert (z. B. Mausklick).	BrowserInvokeEvent
		sandboxType : String [schreibgeschützt] Der Sandbox-Typ für den Browserinhalt.	BrowserInvokeEvent
		securityDomain : String [schreibgeschützt] Die Sicherheitsdomäne für den Browserinhalt, zum Beispiel „www.adobe.com“ oder „www.example.org“.	BrowserInvokeEvent
		target : Object [schreibgeschützt] Das Ereignis-Ziel.	Event
		type : String [schreibgeschützt] Der Ereignistyp.	Event

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean) Die Konstruktorfunktion für die BrowserInvokeEvent-Klasse.	BrowserInvokeEvent
		clone():Event [override] Erstellt eine neue Kopie dieses Ereignisses.	BrowserInvokeEvent
		formatToString(className:String, ... arguments):String Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.	Event
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isDefaultPrevented():Boolean Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.	Event
		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
		preventDefault():void Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.	Event
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		stopImmediatePropagation():void Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.	Event
		stopPropagation():void Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.	Event
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält.	Event
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Öffentliche Konstanten

Vererbte öffentliche Konstanten ausblenden

Vererbte öffentliche Konstanten anzeigen

	Konstante		Definiert von
		BROWSER_INVOKE : String = "browserInvoke" [statisch] Die BrowserInvokeEvent.BROWSER_INVOKE-Konstante definiert den Wert der type-Eigenschaft eines BrowserInvokeEvent-Objekts.	BrowserInvokeEvent

Eigenschaftendetails

arguments

Eigenschaft

arguments:Array [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Ein Array von Argumenten (Strings), die an die Anwendung zu übergeben sind.

Implementierung
public function get arguments():Array

isHTTPS

Eigenschaft

isHTTPS:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Ob der Browserinhalt das HTTPS-URL-Schema verwendet (true) oder nicht (false).

Implementierung
public function get isHTTPS():Boolean

isUserEvent

Eigenschaft

isUserEvent:Boolean [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Ob der Browseraufruf in einem Benutzerereignis resultiert (z. B. Mausklick). In AIR 1.0 ist dies immer auf true gesetzt; AIR benötigt ein Benutzerereignis für die Initiierung des Aufrufs der Browseraufruffunktion.

Implementierung
public function get isUserEvent():Boolean

sandboxType

Eigenschaft

sandboxType:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Der Sandbox-Typ für den Browserinhalt. Dieser Parameter kann auf einen der folgenden Werte eingestellt sein:

Security.APPLICATION – Der Inhalt befindet sich in der Sicherheits-Sandbox der Anwendung.
Security.LOCAL_TRUSTED: Der Inhalt befindet sich in der lokalen vertrauenswürdigen Sicherheitssandbox.
Security.LOCAL_WITH_FILE – Der Inhalt befindet sich in der local-with-filesystem-Sicherheits-Sandbox.
Security.LOCAL_WITH_NETWORK – Der Inhalt befindet sich in der local-with-networking-Sicherheits-Sandbox.
Security.REMOTE – Der Inhalt befindet sich in einer Remote(-Netzwerk)-Domäne.

Implementierung
public function get sandboxType():String

Verwandte API-Elemente

flash.system.Security.sandboxType

securityDomain

Eigenschaft

securityDomain:String [schreibgeschützt]

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Die Sicherheitsdomäne für den Browserinhalt, zum Beispiel www.adobe.com oder www.example.org. Diese Eigenschaft wird nur für Inhalte in der Remote-Sicherheitssandbox (für Inhalte in einer Netzwerkdomäne) eingestellt, nicht für Inhalte in einer lokalen Sicherheitssandbox oder in der Sicherheitssandbox der Anwendung.

Implementierung
public function get securityDomain():String

Konstruktordetails

()

Konstruktor

public function BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean)

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Die Konstruktorfunktion für die BrowserInvokeEvent-Klasse. Im Allgemeinen rufen Entwickler den BrowserInvokeEvent()-Konstruktor nicht direkt auf. Nur die Laufzeitumgebung sollte ein BrowserInvokeEvent-Objekt erstellen.

Parameter

	`type:String` — Der Ereignistyp, auf den als `Event.type` zugegriffen werden kann.

	`bubbles:Boolean` — Einstellung `false` für ein BrowserInvokeEvent-Objekt.

	`cancelable:Boolean` — Einstellung `false` für ein BrowserInvokeEvent-Objekt.

	`arguments:Array` — Ein Array von Argumenten (Strings), die an die Anwendung zu übergeben sind.

	`sandboxType:String` — Der Sandbox-Typ für den Browserinhalt.

	`securityDomain:String` — Die Sicherheitsdomäne für den Browserinhalt.

	`isHTTPS:Boolean` — Ob der Browserinhalt das HTTPS-URL-Schema verwendet.

	`isUserEvent:Boolean` — Ob der Browseraufruf das Ergebnis eines Benutzerereignisses war.

Methodendetails

clone

()

Methode

override public function clone():Event

Laufzeitversionen:

AIR 1.0

Erstellt eine neue Kopie dieses Ereignisses.

Rückgabewerte

Event — Die Kopie des Ereignisses.

Konstantendetails

BROWSER_INVOKE

Konstante

public static const BROWSER_INVOKE:String = "browserInvoke"

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Die BrowserInvokeEvent.BROWSER_INVOKE-Konstante definiert den Wert der type-Eigenschaft eines BrowserInvokeEvent-Objekts.

Das BrowserInvokeEvent-Ereignisobjekt hat folgende Eigenschaften:

Eigenschaften	Werte
`Arguments`	Das Array von Stringargumenten, die während dieses Aufrufs übergeben werden.
`sandBoxType`	Ein String, der den Sandboxtyp für den Browserinhalt angibt (`Security.APPLICATION`, `Security.LOCAL_TRUSTED`, `Security.LOCAL_WITH_FILE`, `Security.LOCAL_LOCAL_WITH_NETWORK` oder `Security.REMOTE`).
`securityDomain`	Ein String, der die Sicherheitsdomäne des Browsers angibt (zum Beispiel `"www.example.com"`).
`isHTTPS`	Ob der Browserinhalt das HTTPS-URL-Schema verwendet (`true`) oder nicht (`false`)
`isUserEvent`	Ob der Browseraufruf aus einem Benutzerereignis resultiert (in AIR 1.0 immer `true`).
`bubbles`	Nein.
`cancelable`	`false`; es gibt kein Standardverhalten, das abgebrochen werden kann.
`currentTarget`	Gibt das Objekt an, welches das InvokeEvent -Objekt aktiv mit einem Ereignis-Listener verarbeitet.
`target`	Immer das NativeApplication-Objekt.

Verwandte API-Elemente

flash.desktop.NativeApplication

Rechtliche Hinweise | Onlinedatenschutzerklärung

BrowserInvokeEvent - AS3

Klassen x

arguments

isHTTPS

isUserEvent

sandboxType

securityDomain