| Paket | flash.events |
| Klasse | public class InvokeEvent |
| Vererbung | InvokeEvent  Event Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
invoke-Ereignis aus, wenn die Anwendung aufgerufen wird.
Das NativeApplication-Objekt löst ein invoke-Ereignis immer dann aus, wenn eine Anwendung gestartet wird. Das Ereignis kann aber auch zu anderen Zeitpunkten ausgelöst werden. Eine laufende Anwendung löst zum Beispiel ein zusätzliches InvokeEvent-Ereignis aus, wenn ein Benutzer eine mit der Anwendung verknüpfte Datei aktiviert.
Es kann jeweils nur eine Instanz einer bestimmten Anwendung gestartet werden. Bei nachfolgenden Versuchen, die Anwendung zu starten, löst das NativeApplication-Objekt der laufenden Instanz ein neues invoke-Ereignis aus. Die Anwendung ist dafür zuständig, dieses Ereignis zu verarbeiten und die entsprechende Aktion auszuführen, zum Beispiel ein neues Anwendungsfenster zum Anzeigen der Daten in der Datei zu öffnen.
InvokeEvent-Objekte werden vom NativeApplication-Objekt (NativeApplication.nativeApplication) ausgelöst. Um invoke-Ereignisse zu erhalten, rufen Sie die addEventListener()-Methode des NativeApplication-Objekts auf. Wenn ein Ereignis-Listener für ein invoke-Ereignis registriert wird, empfängt er auch alle invoke-Ereignisse, die vor der Registrierung aufgetreten sind. Diese früheren Ereignisse werden nach der Rückgabe des Aufrufs von addEventListener() ausgelöst, jedoch nicht unbedingt vor einem neuen invoke-Ereignis, das möglicherweise nach der Registrierung ausgelöst wird. Sie sollten sich also nicht auf eine bestimmte Auslösereihenfolge verlassen.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| arguments : Array [schreibgeschützt]
Das Array von Stringargumenten, die während dieses Aufrufs übergeben werden. | InvokeEvent | ||
 | 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 | |
| currentDirectory : File [schreibgeschützt]
Der Ordner, der verwendet werden sollte, um relative Pfade im Argument-Array aufzulösen. | InvokeEvent | ||
| 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 | |
| reason : String [schreibgeschützt]
Die Ursache für dieses InvokeEvent. | InvokeEvent | ||
| target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | |
| type : String [schreibgeschützt]
Der Ereignistyp. | Event | |
| Methode | Definiert von | ||
|---|---|---|---|
InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")
Die Konstruktorfunktion für die InvokeEvent-Klasse. | InvokeEvent | ||
[override]
Erstellt eine neue Kopie dieses Ereignisses. | InvokeEvent | ||
|
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 | ||
|---|---|---|---|
| INVOKE : String = "invoke" [statisch]
Die InvokeEvent.INVOKE-Konstante definiert den Wert der type-Eigenschaft eines InvokeEvent-Objekts. | InvokeEvent | ||
arguments | Eigenschaft |
arguments:Array [schreibgeschützt] | Laufzeitversionen: | AIR 1.0 |
Das Array von Stringargumenten, die während dieses Aufrufs übergeben werden. Wenn es sich um einen Befehlszeilenaufruf handelt, enthält das Array die Befehlszeilenargumente (ohne den Prozessnamen).
Bei mobilen Plattformen enthält diese Eigenschaft das Array von Optionen, mit denen die Anwendung gestartet wurde, und nicht die Befehlszeilenargumente. Außerdem variiert auf mobilen Plattformen, wenn reason den Wert InvokeEventReason.OPEN_URL hat, der Inhalt des Argumentarrays wie folgt:
- Eine andere Anwendung oder ein Browser ruft die Anwendung mit einer benutzerdefinierten URL auf (iOS und Android):
Arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]source app id action id InvokeEvent.arguments[2]null NA - Das System ruft die Anwendung auf, um einen zugeordneten Dateityp zu öffnen (iOS und Android):
Arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]null action id InvokeEvent.arguments[2]null NA - Eine andere Anwendung ruft die Anwendung mithilfe des Dokumentinteraktionscontrollers auf (nur iOS):
Arguments iOS InvokeEvent.arguments.length3 InvokeEvent.arguments[0]url InvokeEvent.arguments[1]source app id InvokeEvent.arguments[2]annotation
Hinweis: Wenn unter Mac® OS X mehrere Dateien ausgewählt und geöffnet wurden, löst AIR ein einzelnes invoke-Ereignis aus, das im arguments-Array die Namen aller ausgewählten Dateien enthält. Unter Windows® und Linux löst AIR hingegen ein separates invoke-Ereignis für jede ausgewählte Datei aus, das nur den jeweiligen Dateinamen im arguments-Array enthält.
Implementierung
public function get arguments():Array currentDirectory | Eigenschaft |
currentDirectory:File [schreibgeschützt] | Laufzeitversionen: | AIR 1.0 |
Der Ordner, der verwendet werden sollte, um relative Pfade im arguments-Array aufzulösen.
Wenn eine Anwendung von der Befehlszeile aus gestartet wird, ist die Eigenschaft normalerweise auf das aktuelle Arbeitsverzeichnis der Befehlszeilen-Shell eingestellt, von der aus die Anwendung gestartet wurde. Wenn eine Anwendung von der GUI-Shell aus gestartet wird, wird für diese Eigenschaft normalerweise das erste Systemstammverzeichnis verwendet.
Implementierung
public function get currentDirectory():File reason | Eigenschaft |
reason:String [schreibgeschützt] | Laufzeitversionen: | AIR 1.5.1 |
Die Ursache für dieses InvokeEvent. Diese Eigenschaft gibt an, ob die Anwendung vom Benutzer manuell oder beim Anmelden automatisch gestartet wurde. Mögliche Werte werden als Konstanten in der InvokeEventReason-Klasse aufgelistet.
| InvokeEventReason-Konstante | Bedeutung |
|---|---|
LOGIN | Wurde bei der Anmeldung automatisch gestartet. |
NOTIFICATION | Gestartet in Reaktion auf eine Benachrichtigung (nur iOS). |
OPEN_URL | Gestartet, weil die Anwendung von einer anderen Anwendung aufgerufen wurde. |
STANDARD | Wurde aufgrund anderer Ursachen gestartet. |
Hinweis: Bei mobilen Plattformen hat die reason-Eigenschaft nie den Wert LOGIN.
Implementierung
public function get reason():StringVerwandte API-Elemente
InvokeEvent | () | Konstruktor |
public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Die Konstruktorfunktion für die InvokeEvent-Klasse.
Parametertype:String — Der Ereignistyp, auf den als Event.type zugegriffen werden kann.
| |
bubbles:Boolean (default = false)false eingestellt für ein InvokeEvent-Objekt.
| |
cancelable:Boolean (default = false)false eingestellt für ein InvokeEvent-Objekt.
| |
dir:File (default = null)arguments-Array aufzulösen.
| |
argv:Array (default = null) | |
reason:String (default = "standard")InvokeEventReason.LOGIN, InvokeEventReason.STANDARD, InvokeEventReason.OPEN_URL oder InvokeEventReason.NOTIFICATION. (Dieser Parameter ist ab AIR-Version 1.5.1 verfügbar. OPEN_URL und NOTIFICATION sind ab AIR Version 3.5 verfügbar.)
|
Verwandte API-Elemente
clone | () | Methode |
INVOKE | Konstante |
public static const INVOKE:String = "invoke"| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Die InvokeEvent.INVOKE-Konstante definiert den Wert der type-Eigenschaft eines InvokeEvent-Objekts.
Das InvokeEvent-Ereignisobjekt hat folgende Eigenschaften:
| Eigenschaften | Werte |
|---|---|
Arguments | Das Array von Stringargumenten, die während dieses Aufrufs übergeben werden. |
currentDirectory | ein File-Objekt, das den Ordner darstellt, der für die Auflösung relativer Pfade im Argumentarray verwendet wird. |
reason | ein Code, der angibt, ob das Aufrufereignis abgesetzt wurde, weil die Anwendung beim Anmelden automatisch gestartet wurde (InvokeEventReason.LOGIN), als Reaktion auf eine Remotebenachrichtigung gestartet wurde (InvokeEventReason.NOTIFICATION - nur iOS), weil die Anwendung von einer anderen Anwendung aufgerufen wurde (InvokeEventReason.OPEN_URL) oder aus einem anderen Grund (InvokeEventReason.STANDARD). Verfügbar ab AIR 1.5.1. |
bubbles | false. |
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