ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: Daten werden vom Server abgerufen...
Daten werden vom Server abgerufen...
flash.events 

BrowserInvokeEvent  - AS3

Paketflash.events
Klassepublic class BrowserInvokeEvent
VererbungBrowserInvokeEvent Inheritance Event Inheritance 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



Öffentliche Eigenschaften
 EigenschaftDefiniert von
      arguments : Array
[schreibgeschützt] Ein Array von Argumenten (Strings), die an die Anwendung zu übergeben sind.
BrowserInvokeEvent
 Inheritedbubbles : Boolean
[schreibgeschützt] Gibt an, ob es sich bei dem Ereignis um ein Bubbling-Ereignis handelt.
Event
 Inheritedcancelable : Boolean
[schreibgeschützt] Gibt an, ob das mit dem Ereignis verknüpfte Verhalten verhindert werden kann.
Event
 Inheritedconstructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.
Object
 InheritedcurrentTarget : Object
[schreibgeschützt] Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
Event
 InheritedeventPhase : 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
 Inheritedtarget : Object
[schreibgeschützt] Das Ereignis-Ziel.
Event
 Inheritedtype : String
[schreibgeschützt] Der Ereignistyp.
Event
Öffentliche Methoden
 MethodeDefiniert 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
 Inherited
formatToString(className:String, ... arguments):String
Eine Dienstprogrammfunktion zur Implementierung der toString()-Methode in benutzerdefinierten ActionScript 3.0 Event-Klassen.
Event
 Inherited
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
Überprüft, ob die preventDefault()-Methode bei dem Ereignis aufgerufen wurde.
Event
 Inherited
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.
Object
 Inherited
Bricht das Standardverhalten eines Ereignisses ab, wenn dieses Verhalten abgebrochen werden kann.
Event
 Inherited
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern im aktuellen Knoten und in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Verhindert die Verarbeitung von Ereignis-Listenern in Knoten, die dem aktuellen Knoten im Ereignisablauf nachfolgen.
Event
 Inherited
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.
Object
 Inherited
Gibt eine Zeichenfolge zurück, die alle Eigenschaften des Ereignisobjekts enthält.
Event
 Inherited
Gibt den Grundwert des angegebenen Objekts zurück.
Object
Öffentliche Konstanten
 KonstanteDefiniert 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

    

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
    

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.

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:

EigenschaftenWerte
ArgumentsDas Array von Stringargumenten, die während dieses Aufrufs übergeben werden.
sandBoxTypeEin 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).
securityDomainEin String, der die Sicherheitsdomäne des Browsers angibt (zum Beispiel "www.example.com").
isHTTPSOb der Browserinhalt das HTTPS-URL-Schema verwendet (true) oder nicht (false)
isUserEventOb der Browseraufruf aus einem Benutzerereignis resultiert (in AIR 1.0 immer true).
bubblesNein.
cancelablefalse; es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetGibt das Objekt an, welches das InvokeEvent -Objekt aktiv mit einem Ereignis-Listener verarbeitet.
targetImmer das NativeApplication-Objekt.

Verwandte API-Elemente





[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.