| Paket | flash.events |
| Klasse | public class BrowserInvokeEvent |
| Vererbung | BrowserInvokeEvent  Event Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
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
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 | |
| 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 | ||
[override]
Erstellt eine neue Kopie dieses Ereignisses. | BrowserInvokeEvent | ||
|
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen. | Event | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde. | Event | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann. | Event | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | |
|
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen. | Event | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält. | Event | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
| Konstante | Definiert von | ||
|---|---|---|---|
| BROWSER_INVOKE : String = "browserInvoke" [statisch]
Die BrowserInvokeEvent.BROWSER_INVOKE-Konstante definiert den Wert der type-Eigenschaft eines BrowserInvokeEvent-Objekts. | BrowserInvokeEvent | ||
arguments | Eigenschaft |
isHTTPS | Eigenschaft |
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():StringVerwandte API-Elemente
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 BrowserInvokeEvent | () | 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.
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.
|
clone | () | Methode |
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
Tue Jun 12 2018, 10:04 AM Z