| 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
Öffentliche Eigenschaften
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 | |
| prototype : Object [statisch]
Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts. | Object | |
| reason : String [schreibgeschützt]
Die Ursache für dieses InvokeEvent. | InvokeEvent | ||
| target : Object [schreibgeschützt]
Das Ereignis-Ziel. | Event | |
| type : String [schreibgeschützt]
Der Typ des Ereignisses. | Event | |
Öffentliche Methoden
| 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 | |
Öffentliche Konstanten
| Konstante | Definiert von | ||
|---|---|---|---|
| ACTIVATE : String = "activate" [statisch]
Die ACTIVATE-Konstante bestimmt den Wert der type-Eigenschaft eines activate-Ereignisobjekts. | Event | |
| ADDED : String = "added" [statisch]
Die Event.ADDED-Konstante definiert den Wert der type-Eigenschaft eines added-Ereignisobjekts. | Event | |
| ADDED_TO_STAGE : String = "addedToStage" [statisch]
Die Event.ADDED_TO_STAGE-Konstante definiert den Wert der type-Eigenschaft eines addedToStage-Ereignisobjekts. | Event | |
| CANCEL : String = "cancel" [statisch]
Die Event.CANCEL-Konstante definiert den Wert der type-Eigenschaft eines cancel-Ereignisobjekts. | Event | |
| CHANGE : String = "change" [statisch]
Die Event.CHANGE-Konstante definiert den Wert der type-Eigenschaft eines change-Ereignisobjekts. | Event | |
| CLEAR : String = "clear" [statisch]
Die Event.CLEAR-Konstante definiert den Wert der type-Eigenschaft eines clear-Ereignisobjekts. | Event | |
| CLOSE : String = "close" [statisch]
Die Event.CLOSE-Konstante definiert den Wert der type-Eigenschaft eines close-Ereignisobjekts. | Event | |
| CLOSING : String = "closing" [statisch]
Die Event.CLOSING-Konstante definiert den Wert der type-Eigenschaft eines closing-Ereignisobjekts. | Event | |
| COMPLETE : String = "complete" [statisch]
Die Event.COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines complete-Ereignisobjekts. | Event | |
| CONNECT : String = "connect" [statisch]
Die Event.CONNECT-Konstante definiert den Wert der type-Eigenschaft eines connect-Ereignisobjekts. | Event | |
| CONTEXT3D_CREATE : String = "context3DCreate" [statisch]
Die Event.CONTEXT3D_CREATE-Konstante definiert den Wert der type-Eigenschaft eines context3Dcreate-Ereignisobjekts. | Event | |
| COPY : String = "copy" [statisch]
Definiert den Wert der type-Eigenschaft eines copy-Ereignisobjekts. | Event | |
| CUT : String = "cut" [statisch]
Definiert den Wert der type-Eigenschaft eines cut-Ereignisobjekts. | Event | |
| DEACTIVATE : String = "deactivate" [statisch]
Die Event.DEACTIVATE-Konstante definiert den Wert der type-Eigenschaft eines deactivate-Ereignisobjekts. | Event | |
| DISPLAYING : String = "displaying" [statisch]
Die Event.DISPLAYING-Konstante definiert den Wert der type-Eigenschaft eines displaying-Ereignisobjekts. | Event | |
| ENTER_FRAME : String = "enterFrame" [statisch]
Die Event.ENTER_FRAME-Konstante definiert den Wert der type-Eigenschaft eines enterFrame-Ereignisobjekts. | Event | |
| EXIT_FRAME : String = "exitFrame" [statisch]
Die Event.EXIT_FRAME-Konstante definiert den Wert der type-Eigenschaft eines exitFrame-Ereignisobjekts. | Event | |
| EXITING : String = "exiting" [statisch]
Die Event.EXITING-Konstante definiert den Wert der type-Eigenschaft eines exiting-Ereignisobjekts. | Event | |
| FRAME_CONSTRUCTED : String = "frameConstructed" [statisch]
Die Event.FRAME_CONSTRUCTED-Konstante definiert den Wert der type-Eigenschaft eines frameConstructed-Ereignisobjekts. | Event | |
| FULLSCREEN : String = "fullScreen" [statisch]
Die Event.FULL_SCREEN-Konstante definiert den Wert der type-Eigenschaft eines fullScreen-Ereignisobjekts. | Event | |
| HTML_BOUNDS_CHANGE : String = "htmlBoundsChange" [statisch]
Die Event.HTML_BOUNDS_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines htmlBoundsChange-Ereignisobjekts. | Event | |
| HTML_DOM_INITIALIZE : String = "htmlDOMInitialize" [statisch]
Die Event.HTML_DOM_INITIALIZE-Konstante definiert den Wert der type-Eigenschaft eines htmlDOMInitialize-Ereignisobjekts. | Event | |
| HTML_RENDER : String = "htmlRender" [statisch]
Die Event.HTML_RENDER-Konstante definiert den Wert der type-Eigenschaft eines htmlRender-Ereignisobjekts. | Event | |
| ID3 : String = "id3" [statisch]
Die Event.ID3-Konstante definiert den Wert der type-Eigenschaft eines id3-Ereignisobjekts. | Event | |
| INIT : String = "init" [statisch]
Die Event.INIT-Konstante definiert den Wert der type-Eigenschaft eines init-Ereignisobjekts. | Event | |
| INVOKE : String = "invoke" [statisch]
Die InvokeEvent.INVOKE-Konstante definiert den Wert der type-Eigenschaft eines InvokeEvent-Objekts. | InvokeEvent | ||
| LOCATION_CHANGE : String = "locationChange" [statisch]
Die Event.LOCATION_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines locationChange-Ereignisobjekts. | Event | |
| MOUSE_LEAVE : String = "mouseLeave" [statisch]
Die Event.MOUSE_LEAVE-Konstante definiert den Wert der type-Eigenschaft eines mouseLeave-Ereignisobjekts. | Event | |
| NETWORK_CHANGE : String = "networkChange" [statisch]
Die Event.NETWORK_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines networkChange-Ereignisobjekts. | Event | |
| OPEN : String = "open" [statisch]
Die Event.OPEN-Konstante definiert den Wert der type-Eigenschaft eines open-Ereignisobjekts. | Event | |
| PASTE : String = "paste" [statisch]
Die Event.PASTE-Konstante definiert den Wert der type-Eigenschaft eines paste-Ereignisobjekts. | Event | |
| PREPARING : String = "preparing" [statisch]
Die Event.PREPARING-Konstante definiert den Wert der type-Eigenschaft eines preparing-Ereignisobjekts. | Event | |
| REMOVED : String = "removed" [statisch]
Die Event.REMOVED-Konstante definiert den Wert der type-Eigenschaft eines removed-Ereignisobjekts. | Event | |
| REMOVED_FROM_STAGE : String = "removedFromStage" [statisch]
Die Event.REMOVED_FROM_STAGE-Konstante definiert den Wert der type-Eigenschaft eines removedFromStage-Ereignisobjekts. | Event | |
| RENDER : String = "render" [statisch]
Die Event.RENDER-Konstante definiert den Wert der type-Eigenschaft eines render-Ereignisobjekts. | Event | |
| RESIZE : String = "resize" [statisch]
Die Event.RESIZE-Konstante definiert den Wert der type-Eigenschaft eines resize-Ereignisobjekts. | Event | |
| SCROLL : String = "scroll" [statisch]
Die Event.SCROLL-Konstante definiert den Wert der type-Eigenschaft eines scroll-Ereignisobjekts. | Event | |
| SELECT : String = "select" [statisch]
Die Event.SELECT-Konstante definiert den Wert der type-Eigenschaft eines select-Ereignisobjekts. | Event | |
| SELECT_ALL : String = "selectAll" [statisch]
Die Event.SELECT_ALL-Konstante definiert den Wert der type-Eigenschaft eines selectALL-Ereignisobjekts. | Event | |
| SOUND_COMPLETE : String = "soundComplete" [statisch]
Die Event.SOUND_COMPLETE-Konstante definiert den Wert der type-Eigenschaft eines soundComplete-Ereignisobjekts. | Event | |
| STANDARD_ERROR_CLOSE : String = "standardErrorClose" [statisch]
Die Event.STANDARD_ERROR_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardErrorClose-Ereignisobjekts. | Event | |
| STANDARD_INPUT_CLOSE : String = "standardInputClose" [statisch]
Die Event.STANDARD_INPUT_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardInputClose-Ereignisobjekts. | Event | |
| STANDARD_OUTPUT_CLOSE : String = "standardOutputClose" [statisch]
Die Event.STANDARD_OUTPUT_CLOSE-Konstante definiert den Wert der type-Eigenschaft eines standardOutputClose-Ereignisobjekts. | Event | |
| TAB_CHILDREN_CHANGE : String = "tabChildrenChange" [statisch]
Die Event.TAB_CHILDREN_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabChildrenChange-Ereignisobjekts. | Event | |
| TAB_ENABLED_CHANGE : String = "tabEnabledChange" [statisch]
Die Event.TAB_ENABLED_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabEnabledChange-Ereignisobjekts. | Event | |
| TAB_INDEX_CHANGE : String = "tabIndexChange" [statisch]
Die Event.TAB_INDEX_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines tabIndexChange-Ereignisobjekts. | Event | |
| TEXT_INTERACTION_MODE_CHANGE : String = "textInteractionModeChange" [statisch]
Die Event.TEXT_INTERACTION_MODE_CHANGE-Konstante definiert den Wert der type-Eigenschaft eines Interaktionsmodusereignisobjekts. | Event | |
| UNLOAD : String = "unload" [statisch]
Die Event.UNLOAD-Konstante definiert den Wert der type-Eigenschaft eines unload-Ereignisobjekts. | Event | |
| USER_IDLE : String = "userIdle" [statisch]
Die Event.USER_IDLE-Konstante definiert den Wert der type-Eigenschaft eines userIdle-Ereignisobjekts. | Event | |
| USER_PRESENT : String = "userPresent" [statisch]
Die Event.USER_PRESENT-Konstante definiert den Wert der type-Eigenschaft eines userPresent-Ereignisobjekts. | Event | |
Eigenschaftendetails
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).
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. |
STANDARD | Wurde aufgrund anderer Ursachen gestartet. |
Implementierung
public function get reason():StringVerwandte API-Elemente
Konstruktordetails
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 Typ des Ereignisses, 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 oder InvokeEventReason.STANDARD. (Dieser Parameter ist ab AIR 1.5.1 verfügbar.)
|
Verwandte API-Elemente
Methodendetails
clone | () | Methode |
Konstantendetails
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 invoke-Ereignis ausgelöst wurde, weil die Anwendung beim Anmelden automatisch gestartet wurde (InvokeEventReason.LOGIN), 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
Wed Apr 11 2012, 04:58 AM -07:00