| Pakket | flash.events |
| Klasse | public class InvokeEvent |
| Overerving | InvokeEvent  Event Object |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0 |
Invoke-gebeurtenis wanneer de toepassing wordt geactiveerd.
Het NativeApplication-object verzendt altijd een Invoke-gebeurtenis wanneer een toepassing wordt gestart, maar de gebeurtenis kan ook op andere momenten worden verzonden. Een actieve toepassing verzendt bijvoorbeeld een extra InvokeEvent wanneer een gebruiker een bestand activeert dat aan de toepassing is gekoppeld.
Er kan maar één enkele instantie van een bepaalde toepassing worden gestart. Opeenvolgende pogingen om de toepassing te starten, hebben tot gevolg dat een nieuwe invoke-gebeurtenis wordt verzonden door het NativeApplication-object van de actieve instantie. Het is de verantwoordelijkheid van de toepassing om deze gebeurtenis af te handelen en de juiste actie te ondernemen, zoals het openen van een nieuw toepassingsvenster om de gegevens in een bestand weer te geven.
InvokeEvent-objecten worden verzonden door het NativeApplication-object (NativeApplication.nativeApplication). Roep de methode addEventListener() van het NativeApplication-object aan om Invoke-gebeurtenissen te ontvangen. Wanneer een gebeurtenislistener zich registreert voor een Invoke-gebeurtenis, ontvangt deze ook alle Invoke-gebeurtenissen die zich vóór de registratie hebben voorgedaan. Deze eerdere gebeurtenissen worden verzonden nadat de aanroep van addEventListener() is geretourneerd, maar niet noodzakelijk vóór een nieuwe invoke-gebeurtenis die na registratie mogelijk wordt verzonden. U mag dus nooit vertrouwen op de volgorde van de verzendingen.
Verwante API-elementen
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
| arguments : Array [alleen-lezen]
De array met tekenreeksargumenten die tijdens de activering wordt doorgegeven. | InvokeEvent | ||
 | bubbles : Boolean [alleen-lezen]
Geeft aan of een gebeurtenis een terugkoppelgebeurtenis is. | Event | |
| cancelable : Boolean [alleen-lezen]
Geeft aan of het gedrag dat aan deze gebeurtenis is gekoppeld, kan worden voorkomen. | Event | |
| constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| currentDirectory : File [alleen-lezen]
De map die moet worden gebruikt voor het oplossen van relatieve paden in de array arguments. | InvokeEvent | ||
| currentTarget : Object [alleen-lezen]
Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener. | Event | |
| eventPhase : uint [alleen-lezen]
De huidige fase in de gebeurtenisstroom. | Event | |
| reason : String [alleen-lezen]
De reden voor deze InvokeEvent. | InvokeEvent | ||
| target : Object [alleen-lezen]
Doel van gebeurtenis. | Event | |
| type : String [alleen-lezen]
Het type gebeurtenis. | Event | |
| Methode | Gedefinieerd door | ||
|---|---|---|---|
InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")
De constructorfunctie voor de InvokeEvent-klasse. | InvokeEvent | ||
[overschrijven]
Maakt een nieuw exemplaar van deze gebeurtenis. | InvokeEvent | ||
|
Een hulpprogrammafunctie voor de implementatie van de methode toString() in aangepaste ActionScript 3.0-Event-klassen. | Event | |
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Controleert of de methode preventDefault() is aangeroepen voor de gebeurtenis. | Event | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Annuleert het standaardgedrag van een gebeurtenis wanneer dat gedrag kan worden geannuleerd. | Event | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Voorkomt het verwerken van gebeurtenislisteners in het huidige knooppunt en volgende knooppunten in de gebeurtenisstroom. | Event | |
|
Voorkomt het verwerken van gebeurtenislisteners in knooppunten die volgen op het huidige knooppunt in de gebeurtenisstroom. | Event | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeks die alle eigenschappen van het Event-object bevat. | Event | |
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
| Constante | Gedefinieerd door | ||
|---|---|---|---|
| INVOKE : String = "invoke" [statisch]
De constante InvokeEvent.INVOKE definieert de waarde van de eigenschap type van een InvokeEvent-object. | InvokeEvent | ||
arguments | eigenschap |
arguments:Array [alleen-lezen] | Runtimeversies: | AIR 1.0 |
De array met tekenreeksargumenten die tijdens de activering wordt doorgegeven. Als dit een opdrachtregelactivering is, bevat de array de opdrachtregelargumenten (zonder de procesnaam).
Bij mobiele platforms bevat deze eigenschap de array met opties waarmee de toepassing werd gestart en niet de opdrachtregelargumenten. Als bovendien op mobiele platforms reason InvokeEventReason.OPEN_URL is, zal de inhoud van de arguments-array als volgt variëren:
- Een andere toepassing of browser roept de toepassing aan met een aangepaste URL (iOS en Android):
argumenten iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]id van brontoepassing id van handeling InvokeEvent.arguments[2]null N.v.t. - Het systeem roept de toepassing aan om een gekoppeld bestandstype te openen (iOS en Android):
argumenten iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]null id van handeling InvokeEvent.arguments[2]null N.v.t. - Een andere toepassing roept de toepassing aan met behulp van de documentinteractiecontroller (alleen iOS):
argumenten iOS InvokeEvent.arguments.length3 InvokeEvent.arguments[0]url InvokeEvent.arguments[1]id van brontoepassing InvokeEvent.arguments[2]annotation
Opmerking:als meerdere bestanden zijn geselecteerd en geopend op Mac® OS X, verzendt AIR een enkele invoke-gebeurtenis die in de array arguments de namen bevat van alle geselecteerde bestanden. In Windows ® en Linux verzendt AIR echter een afzonderlijke invoke-gebeurtenis voor elk geselecteerd bestand dat alleen die bestandsnaam bevat in de array arguments.
Implementatie
public function get arguments():Array currentDirectory | eigenschap |
currentDirectory:File [alleen-lezen] | Runtimeversies: | AIR 1.0 |
De map die moet worden gebruikt voor het oplossen van relatieve paden in de array arguments.
Als een toepassing vanaf de opdrachtregel is gestart, is deze eigenschap gewoonlijk ingesteld op de huidige werkmap van de opdrachtregelshell van waaruit de toepassing is gestart. Als een toepassing vanuit de grafische gebruikersinterface is gestart, is de map gewoonlijk ingesteld op de hoofdmap van het systeem.
Implementatie
public function get currentDirectory():File reason | eigenschap |
reason:String [alleen-lezen] | Runtimeversies: | AIR 1.5.1 |
De reden voor deze InvokeEvent. Deze eigenschap geeft aan of de toepassing handmatig door de gebruiker is gestart of automatisch bij het aanmelden. Mogelijke waarden worden opgesomd als constanten in de klasse InvokeEventReason:
| InvokeEventReason-constante | Betekenis |
|---|---|
LOGIN | Automatisch gestart bij het aanmelden. |
NOTIFICATION | Gestart als antwoord op een bericht (alleen iOS). |
OPEN_URL | Gestart omdat de toepassing werd aangeroepen door een andere toepassing. |
STANDARD | Gestart om een andere reden. |
Opmerking: op mobiele platforms wordt de eigenschap reason nooit ingesteld op LOGIN.
Implementatie
public function get reason():StringVerwante API-elementen
InvokeEvent | () | Constructor |
public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0 |
De constructorfunctie voor de InvokeEvent-klasse.
Parameterstype:String — Het type gebeurtenis dat toegankelijk is als Event.type.
| |
bubbles:Boolean (default = false)false voor een InvokeEvent-object.
| |
cancelable:Boolean (default = false)false voor een InvokeEvent-object.
| |
dir:File (default = null)arguments.
| |
argv:Array (default = null) | |
reason:String (default = "standard")InvokeEventReason.LOGIN, InvokeEventReason.STANDARD, InvokeEventReason.OPEN_URL of InvokeEventReason.NOTIFICATION. (Deze parameter is beschikbaar vanaf AIR-versie 1.5.1. OPEN_URL en NOTIFICATION zijn beschikbaar vanaf AIR-versie 3.5.)
|
Verwante API-elementen
clone | () | methode |
INVOKE | Constante |
public static const INVOKE:String = "invoke"| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0 |
De constante InvokeEvent.INVOKE definieert de waarde van de eigenschap type van een InvokeEvent-object.
Het InvokeEvent-object heeft de volgende eigenschappen:
| Eigenschappen | Waarden |
|---|---|
arguments | De array met tekenreeksargumenten die tijdens de activering wordt doorgegeven. |
currentDirectory | File-object dat de map voorstelt die moet worden gebruikt voor het oplossen van relatieve paden in de array met argumenten. |
reason | een code die aangeeft of de aanroepgebeurtenis werd verzonden omdat de toepassing automatisch is gestart bij aanmelding (InvokeEventReason.LOGIN), werd gestart als antwoord op een extern bericht (InvokeEventReason.NOTIFICATION, alleen iOS), omdat de toepassing werd aangeroepen door een andere toepassing (InvokeEventReason.OPEN_URL) of om een andere reden (InvokeEventReason.STANDARD). Beschikbaar vanaf AIR-versie 1.5.1. |
bubbles | false. |
cancelable | false; er is geen standaardgedrag om te annuleren. |
currentTarget | Geeft het object aan dat dit InvokeEvent-object actief verwerkt met een gebeurtenislistener. |
target | Altijd het NativeApplication-object. |
Verwante API-elementen
Wed Jun 13 2018, 11:42 AM Z