| Paket | flash.events |
| Klass | public class InvokeEvent |
| Arv | InvokeEvent  Event Object |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
invoke-händelse när programmet anropas.
NativeApplication-objektet skickar alltid en invoke-händelse när ett program startas, men händelsen kan även skickas vid andra tidpunkter. Ett program som körs skickar till exempel ytterligare ett InvokeEvent när en användare aktiverar en fil som är associerad med programmet.
Endast en instans av ett särskilt program kan startas. Efterföljande försök att starta programmet resulterar i att en ny invoke-händelse skickas av NativeApplication-objektet på den instans som körs. Det är programmets ansvar att hantera händelsen och vidta lämplig åtgärd, som att öppna ett nytt programfönster för att visa filens innehåll.
InvokeEvent-objekt skickas av NativeApplication-objektet (NativeApplication.nativeApplication). Om du vill ta emot invoke-händelser, måste du anropa NativeApplication-objektets addEventListener()-metod. När en händelseavlyssnare registrerar sig till en invoke-händelse, kommer den också att få alla invoke-händelser som har inträffat innan registreringen. Dessa tidigare händelser skickas efter att anropet till addEventListener() returneras, men inte nödvändigtvis innan en ny invoke-händelse som kan tas emot efter registrering. Du ska alltså inte lita på ordningen som de skickas i.
Relaterade API-element
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper| Egenskap | Definieras med | ||
|---|---|---|---|
| arguments : Array [skrivskyddad]
Arrayen med strängargument som har skickats vid det här anropet. | InvokeEvent | ||
 | bubbles : Boolean [skrivskyddad]
indikerar om händelsen är en bubblande händelse. | Event | |
| cancelable : Boolean [skrivskyddad]
Indikerar om beteendet som är kopplat till händelsen kan förhindras. | Event | |
| constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| currentDirectory : File [skrivskyddad]
Katalogen som ska användas för att lösa relativa sökvägar i arguments-arrayen. | InvokeEvent | ||
| currentTarget : Object [skrivskyddad]
Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. | Event | |
| eventPhase : uint [skrivskyddad]
Den nuvarande fasen i händelseflödet. | Event | |
| reason : String [skrivskyddad]
Orsaken till denna InvokeEvent-händelse. | InvokeEvent | ||
| target : Object [skrivskyddad]
Händelsens mål. | Event | |
| type : String [skrivskyddad]
Händelsens typ. | Event | |
| Metod | Definieras med | ||
|---|---|---|---|
InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")
Konstruktorsfunktionen för klassen InvokeEvent. | InvokeEvent | ||
[åsidosätt]
Skapar en ny kopia av den här händelsen. | InvokeEvent | ||
|
Ett verktyg som används för att implementera metoden toString() i de anpassade klasserna ActionScript 3.0. | Event | |
|
Anger om det finns en egenskap angiven för ett objekt. | Object | |
|
Kontrollerar om preventDefault()-metoden har anropats för händelsen. | Event | |
|
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | |
|
Avbryter en händelses standardbeteende om det beteendet kan avbrytas. | Event | |
|
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | |
|
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | |
|
Förhindrar behandling av händelsehanterare i den aktuella noden och alla noder som följer den aktuella noden i händelseflödet. | Event | |
|
Förhindrar behandling av händelsehanterare i noder som följer den aktuella noden i händelseflödet. | Event | |
|
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | |
|
Returnerar en sträng som innehåller alla egenskaper i Event-objektet. | Event | |
|
Returnerar det angivna objektets primitiva värde. | Object | |
| Konstant | Definieras med | ||
|---|---|---|---|
| INVOKE : String = "invoke" [statisk]
InvokeEvent.INVOKE-konstanten definierar värdet på type-egenskapen i ett InvokeEvent-objekt. | InvokeEvent | ||
arguments | egenskap |
arguments:Array [skrivskyddad] | Körningsmiljöversioner: | AIR 1.0 |
Arrayen med strängargument som har skickats vid det här anropet. Om det här är ett kommandoradsanrop innehåller arrayen kommandoradsargumenten (exklusive processnamnet).
På mobila plattformar innehåller den här egenskapen arrayen med alternativ som användes när programmet startades, inte kommandoradsargumenten. På mobila plattformar varierar innehållet i arguments-arrayen dessutom när reason är InvokeEventReason.OPEN_URL, enligt följande:
- Ett annat program eller en annan webbläsare anropar programmet med en anpassad URL (iOS och Android):
argument iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]ID för källprogram åtgärds-ID InvokeEvent.arguments[2]null Ej tillämpligt - Systemet anropar programmet för att öppna en associerad filtyp (iOS och Android):
argument iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]null åtgärds-ID InvokeEvent.arguments[2]null Ej tillämpligt - Ett annat program anropar programmet med hjälp av Document Interaction Controller (endast iOS):
argument iOS InvokeEvent.arguments.length3 InvokeEvent.arguments[0]url InvokeEvent.arguments[1]ID för källprogram InvokeEvent.arguments[2]kommentar
Obs! När flera filer väljs och öppnas i Mac® OS X, skickar AIR en enkel invoke-händelse som innehåller namnen på alla de filer som har valts i arguments-arrayen. I Windows® och Linux kommer dock AIR att skicka en separat invoke-händelse för varje markerad fil som endast innehåller det filnamn som finns i arguments-arrayen.
Implementering
public function get arguments():Array currentDirectory | egenskap |
currentDirectory:File [skrivskyddad] | Körningsmiljöversioner: | AIR 1.0 |
Katalogen som ska användas för att lösa relativa sökvägar i arguments-arrayen.
Om ett program startas från kommandoraden, anges den här egenskapen vanligtvis till den aktuella arbetskatalogen i den kommandorad från vilken programmet startades. Om ett program startas från GUI-skalet, är det vanligtvis systemrotfilen.
Implementering
public function get currentDirectory():File reason | egenskap |
reason:String [skrivskyddad] | Körningsmiljöversioner: | AIR 1.5.1 |
Orsaken till denna InvokeEvent-händelse. Den här egenskapen anger om programmet har startats manuellt av användaren eller automatiskt vid inloggningen. Möjliga värden är konstanter i klassen InvokeEventReason:
| InvokeEventReason-konstant | Betydelse |
|---|---|
LOGIN | Har startats automatiskt vid inloggning. |
NOTIFICATION | Skickas som svar på ett meddelande (endast iOS). |
OPEN_URL | Skickas om programmet anropades av annat program. |
STANDARD | Startades av någon annan anledning. |
Obs! På mobila plattformar är egenskapen reason aldrig inställd på LOGIN.
Implementering
public function get reason():StringRelaterade API-element
InvokeEvent | () | Konstruktor |
public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Konstruktorsfunktionen för klassen InvokeEvent.
Parametrartype:String — Händelsens typ, tillgänglig som Event.type.
| |
bubbles:Boolean (default = false)false för ett InvokeEvent-objekt.
| |
cancelable:Boolean (default = false)false för ett InvokeEvent-objekt.
| |
dir:File (default = null)arguments-arrayen.
| |
argv:Array (default = null) | |
reason:String (default = "standard")InvokeEventReason.LOGIN, InvokeEventReason.STANDARD, InvokeEventReason.OPEN_URL eller InvokeEventReason.NOTIFICATION. (Den här parametern är tillgänglig från och med AIR version 1.5.1. OPEN_URL och NOTIFICATION är tillgängliga från och med AIR version 3.5.)
|
Relaterade API-element
clone | () | metod |
INVOKE | Konstant |
public static const INVOKE:String = "invoke"| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
InvokeEvent.OPEN-konstanten definierar värdet på type-egenskapen i ett InvokeEvent-objekt.
InvokeEvent-objektet har följande egenskaper:
| Egenskaper | Värden |
|---|---|
argument | Arrayen med strängargument som har skickats vid det här anropet. |
currentDirectory | ett File-objekt som representerar katalogen som ska användas för att lösa relativa sökvägar i arguments-arrayen. |
reason | kod som anger om invoke-händelsen skickades eftersom programmet startades automatiskt vid inloggning (InvokeEventReason.LOGIN), startades som svar på ett fjärrmeddelande (InvokeEventReason.NOTIFICATION – endast iOS), anropades av ett annat program (InvokeEventReason.OPEN_URL) eller startades av någon annan orsak (InvokeEventReason.STANDARD). Tillgänglig från och med AIR version 1.5.1. |
bubbles | false. |
cancelable | false; det finns inget standardbeteende att avbryta. |
currentTarget | Anger det objekt som aktivt behandlar InvokeEvent-objektet med en händelseavlyssnare. |
target | Alltid NativeApplication-objektet. |
Relaterade API-element
Tue Jun 12 2018, 01:40 PM Z