| Pacchetto | flash.events |
| Classe | public class InvokeEvent |
| Ereditarietà | InvokeEvent  Event Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
invoke quando l'applicazione viene chiamata.
L'oggetto NativeApplication invia sempre un evento invoke quando un'applicazione viene avviata, tuttavia, tale evento può essere inviato anche in altri momenti. Ad esempio, un'applicazione in esecuzione invia un evento InvokeEvent aggiuntivo ogni volta che un utente attiva un file associato all'applicazione.
È possibile lanciare una sola istanza di una particolare applicazione. Tentativi successivi di lanciare l'applicazione generano nuovi eventi invoke inviati dall'oggetto NativeApplication dell'istanza in esecuzione. È compito dell'applicazione gestire l'evento e intraprendere l'azione appropriata, come aprire una nuova finestra dell'applicazione per visualizzare i dati in un file.
Gli oggetti InvokeEvent vengono inviati dall'oggetto NativeApplication (NativeApplication.nativeApplication). Per ricevere eventi invoke, dovete chiamare il metodo addEventListener() dell'oggetto NativeApplication. Quando un listener di eventi si registra per un evento invoke, esso riceve anche tutti gli eventi invoke che si sono verificati prima della registrazione. Questi eventi precedenti vengono inviati dopo la restituzione della chiamata al metodo addEventListener(), ma non necessariamente prima di altri eventi invoke che potrebbero essere inviati dopo la registrazione. Non fate quindi affidamento su un ordine di invio.
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| arguments : Array [sola lettura]
L'array di argomenti String passati durante la chiamata. | InvokeEvent | ||
 | bubbles : Boolean [sola lettura]
Indica se un evento è un evento di bubbling. | Event | |
| cancelable : Boolean [sola lettura]
Indica se il comportamento associato all'evento può essere impedito. | Event | |
| constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| currentDirectory : File [sola lettura]
La directory che deve essere utilizzata per risolvere percorsi relativi nell'array di argomenti. | InvokeEvent | ||
| currentTarget : Object [sola lettura]
L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi. | Event | |
| eventPhase : uint [sola lettura]
La fase attuale del flusso di eventi. | Event | |
| reason : String [sola lettura]
Il motivo di questo evento InvokeEvent. | InvokeEvent | ||
| target : Object [sola lettura]
Il target dell'evento. | Event | |
| type : String [sola lettura]
Il tipo di evento. | Event | |
| Metodo | Definito da | ||
|---|---|---|---|
InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")
La funzione di costruzione per la classe InvokeEvent. | InvokeEvent | ||
[override]
Crea una nuova copia di questo evento. | InvokeEvent | ||
|
Una funzione dell'utilità per l'implementazione del metodo toString() in classi Event ActionScript 3.0 personalizzate. | Event | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Verifica se sull'evento è stato chiamato il metodo preventDefault(). | Event | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Annulla il comportamento predefinito di un evento se tale comportamento può essere annullato. | Event | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Impedisce l'elaborazione di tutti i listener di eventi nel nodo corrente e in tutti i nodi successivi del flusso di eventi. | Event | |
|
Impedisce l'elaborazione di tutti i listener di eventi nei nodi del flusso di eventi successivi a quello corrente. | Event | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce una stringa che contiene tutte le proprietà dell'oggetto Event. | Event | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
| Costante | Definito da | ||
|---|---|---|---|
| INVOKE : String = "invoke" [statico]
La costante InvokeEvent.INVOKE definisce il valore della proprietà type di un oggetto evento InvokeEvent. | InvokeEvent | ||
arguments | proprietà |
arguments:Array [sola lettura] | Versioni runtime: | AIR 1.0 |
L'array di argomenti String passati durante la chiamata. Se si tratta di una chiamata dalla riga di comando, l'array conterrà gli argomenti della riga di comando (escluso il nome del processo).
Sulle piattaforme mobili, questa proprietà contiene l’array di opzioni con il quale l’applicazione è stata avviata, non gli argomenti della riga di comando. Inoltre, sulle piattaforme mobili, quando reason è InvokeEventReason.OPEN_URL, il contenuto dell’array arguments varia nel modo seguente:
- Un’altra applicazione o un browser chiama l’applicazione con un URL personalizzato (iOS e 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 N/A - Il sistema chiama l’applicazione per aprire un tipo di file associato (iOS e Android):
arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]null action id InvokeEvent.arguments[2]null N/A - Un’altra applicazione chiama l’applicazione utilizzando il controller di interazione documento (solo iOS):
arguments iOS InvokeEvent.arguments.length3 InvokeEvent.arguments[0]url InvokeEvent.arguments[1]source app id InvokeEvent.arguments[2]annotation
Nota: se più file vengono selezionati e aperti in Mac® OS X, AIR invia un solo evento invoke contenente i nomi di tutti i file selezionati nell'array arguments. In Windows® e Linux invece AIR invia un evento invoke distinto per ogni file selezionato contenente solo il nome del file nell'array arguments.
Implementazione
public function get arguments():Array currentDirectory | proprietà |
currentDirectory:File [sola lettura] | Versioni runtime: | AIR 1.0 |
La directory che deve essere utilizzata per risolvere i percorsi relativi nell'array arguments.
Se un'applicazione viene avviata dalla riga di comando, questa proprietà viene generalmente impostata sulla directory di lavoro corrente della shell della riga di comando dalla quale l'applicazione è stata avviata. Se l'applicazione viene avviata dalla shell dell'interfaccia utente, in genere si tratta della directory principale di sistema.
Implementazione
public function get currentDirectory():File reason | proprietà |
reason:String [sola lettura] | Versioni runtime: | AIR 1.5.1 |
Il motivo di questo evento InvokeEvent. Questa proprietà indica se l'applicazione è stata avviata manualmente dall'utente oppure automaticamente al momento del login. I valori possibili vengono enumerati sotto forma di costanti nella classe InvokeEventReason:
| Costante InvokeEventReason | Significato |
|---|---|
LOGIN | Avviata automaticamente durante il login. |
NOTIFICATION | Avviata in risposta a una notifica (solo iOS). |
OPEN_URL | Avviata perché l’applicazione è stata chiamata da un’altra applicazione. |
STANDARD | Avviata per un altro motivo. |
Nota: sulle piattaforme mobili, la proprietà reason non è mai impostata su LOGIN.
Implementazione
public function get reason():StringElementi API correlati
InvokeEvent | () | Funzione di costruzione |
public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
La funzione di costruzione per la classe InvokeEvent.
Parametritype:String — Il tipo di evento, accessibile come Event.type.
| |
bubbles:Boolean (default = false)false per un oggetto InvokeEvent.
| |
cancelable:Boolean (default = false)false per un oggetto InvokeEvent.
| |
dir:File (default = null)arguments.
| |
argv:Array (default = null) | |
reason:String (default = "standard")InvokeEventReason.LOGIN, InvokeEventReason.STANDARD, InvokeEventReason.OPEN_URL o InvokeEventReason.NOTIFICATION. (Questo parametro è disponibile come versione AIR 1.5.1. OPEN_URL e NOTIFICATION sono disponibili a partire da AIR versione 3.5.)
|
Elementi API correlati
clone | () | metodo |
INVOKE | Costante |
public static const INVOKE:String = "invoke"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
La costante InvokeEvent.INVOKE definisce il valore della proprietà type di un oggetto evento InvokeEvent.
L'oggetto InvokeEvent ha le proprietà seguenti:
| Proprietà | Valori |
|---|---|
arguments | L'array di argomenti String passati durante la chiamata. |
currentDirectory | Oggetto file che rappresenta la directory da utilizzare per risolvere i percorsi relativi nell'array arguments. |
reason | un codice che indica se l’evento invoke è stato inviato perché l’applicazione è stata avviata automaticamente al momento del login (InvokeEventReason.LOGIN), avviata in risposta a una notifica remota (InvokeEventReason.NOTIFICATION - solo per iOS), perché l’applicazione è stata chiamata da un’altra applicazione (InvokeEventReason.OPEN_URL) o per un altro motivo (InvokeEventReason.STANDARD). Disponibile a partire da AIR 1.5.1. |
bubbles | false. |
cancelable | false; non è presente alcun comportamento predefinito da annullare. |
currentTarget | Indica l'oggetto che sta elaborando attivamente questo oggetto InvokeEvent con un listener di eventi. |
target | Sempre l'oggetto NativeApplication. |
Elementi API correlati
Tue Jun 12 2018, 02:44 PM Z