| Pacchetto | flash.events |
| Classe | public class BrowserInvokeEvent |
| Ereditarietà | BrowserInvokeEvent  Event Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
browserInvoke quando l'applicazione viene chiamata a seguito della funzione di chiamata del browser utilizzata da un file SWF nel browser. L'oggetto NativeApplication invia anche un evento browserInvoke quando un utente avvia un'istanza della funzione di installazione invisibile nel browser e il file SWF nel browser passa un array al parametro arguments del metodo launchApplication() del file air.swf. Per maggiori informazioni, vedete il capitolo "Distribuzione, installazione ed esecuzione di applicazioni AIR" nella guida per gli sviluppatori AIR.
La chiamata al browser è consentita solo se un'applicazione specifica quanto segue nel file descrittore dell'applicazione:
<allowBrowserInvocation>true</allowBrowserInvocation>
Se l'applicazione non è in esecuzione, l'oggetto NativeApplication invia sia l'evento InvokeEvent che l'evento browserInvoke quando viene avviato dal browser. Se invece l'applicazione è già in esecuzione, l'oggetto NativeApplication invia solo un evento browserInvoke quando viene avviato dal browser.
Se l'applicazione viene avviata in seguito a un'installazione invisibile dal browser (in cui l'utente ha scelto di avviare l'applicazione al termine dell'installazione), l'oggetto NativeApplication invia un evento BrowserInvoke solo se sono stati passati argomenti (mediante il file SWF del browser che passa un array al parametro arguments del metodo installApplication() del file air.swf). Per maggiori informazioni, vedete la sezione "Distribuzione, installazione ed esecuzione di applicazioni AIR" della guida per gli sviluppatori AIR.
Come gli eventi InvokeEvent, gli eventi browserInvokeEvent vengono inviati dall'oggetto NativeApplication (NativeApplication.nativeApplication). Per ricevere eventi browserInvoke, dovete chiamare il metodo addEventListener() dell'oggetto NativeApplication. Quando un listener di eventi si registra per un evento browserInvoke, esso riceverà anche tutti gli eventi browserInvoke che si sono verificati prima della registrazione. Questi eventi vengono inviati dopo la restituzione della chiamata al metodo addEventListener(), ma non necessariamente prima di altri eventi browserInvoke che potrebbero essere ricevuti dopo la registrazione. In questo modo, vi sarà possibile gestire gli eventi browserInvoke che si sono verificati prima dell'esecuzione del vostro codice di inizializzazione (ad esempio, quando l'applicazione è stata inizialmente richiamata dal browser). Tenete presente che se aggiungete un listener di eventi in un momento successivo dell'esecuzione (dopo l'inizializzazione dell'applicazione), esso riceve comunque tutti gli eventi browserInvoke che si sono verificati dall'avvio dell'applicazione.
Elementi API correlati
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| arguments : Array [sola lettura]
Un array di argomenti (stringhe) da passare all'applicazione. | BrowserInvokeEvent | ||
 | 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 | |
| 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 | |
| isHTTPS : Boolean [sola lettura]
Indica se il contenuto del browser utilizza lo schema HTTPS URL (true) o meno (false). | BrowserInvokeEvent | ||
| isUserEvent : Boolean [sola lettura]
Indica se la chiamata al browser ha generato un evento utente (ad esempio un clic del mouse). | BrowserInvokeEvent | ||
| sandboxType : String [sola lettura]
Il tipo di sandbox del contenuto del browser. | BrowserInvokeEvent | ||
| securityDomain : String [sola lettura]
Il dominio di sicurezza per il contenuto del browser, ad esempio "www.adobe.com" oppure "www.example.org". | BrowserInvokeEvent | ||
| target : Object [sola lettura]
Il target dell'evento. | Event | |
| type : String [sola lettura]
Il tipo di evento. | Event | |
| Metodo | Definito da | ||
|---|---|---|---|
BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean)
La funzione di costruzione per la classe BrowserInvokeEvent. | BrowserInvokeEvent | ||
[override]
Crea una nuova copia di questo evento. | BrowserInvokeEvent | ||
|
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 | ||
|---|---|---|---|
| BROWSER_INVOKE : String = "browserInvoke" [statico]
La costante BrowserInvokeEvent.BROWSER_INVOKE definisce il valore della proprietà type di un oggetto BrowserInvokeEvent. | BrowserInvokeEvent | ||
arguments | proprietà |
isHTTPS | proprietà |
isUserEvent | proprietà |
isUserEvent:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Indica se la chiamata al browser ha generato un evento utente (ad esempio un clic del mouse). In AIR 1.0, è sempre impostato su true; AIR richiede un evento utente per avviare una chiamata alla funzione di chiamata del browser.
Implementazione
public function get isUserEvent():Boolean sandboxType | proprietà |
sandboxType:String [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Il tipo di sandbox del contenuto del browser. Può assumere uno dei seguenti valori:
Security.APPLICATION: il contenuto si trova nella sandbox di sicurezza dell'applicazione.Security.LOCAL_TRUSTED: Il contenuto si trova nella sandbox di sicurezza locale affidabile.Security.LOCAL_WITH_FILE: il contenuto si trova nella sandbox di sicurezza locale con file system.Security.LOCAL_WITH_NETWORK: il contenuto si trova nella sandbox di sicurezza locale con collegamento di rete.Security.REMOTE: il contenuto si trova in un dominio (rete) remoto.
Implementazione
public function get sandboxType():StringElementi API correlati
securityDomain | proprietà |
securityDomain:String [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Il dominio di sicurezza per il contenuto del browser, ad esempio "www.adobe.com" oppure "www.example.org". Questa proprietà viene impostata unicamente per contenuto in una sandbox di sicurezza remota (per contenuto proveniente da un dominio di rete) e non per contenuto in una sandbox di sicurezza locale o dell'applicazione.
Implementazione
public function get securityDomain():String BrowserInvokeEvent | () | Funzione di costruzione |
public function BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean)| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
La funzione di costruzione per la classe BrowserInvokeEvent. In genere, gli sviluppatori non chiamano direttamente la funzione di costruzione BrowserInvokeEvent(). Solo il runtime dovrebbe creare un oggetto BrowserInvokeEvent.
type:String — Il tipo di evento, accessibile come Event.type.
| |
bubbles:Boolean — Impostato su false per un oggetto BrowserInvokeEvent.
| |
cancelable:Boolean — Impostato su false per un oggetto BrowserInvokeEvent.
| |
arguments:Array — Un array di argomenti (stringhe) da passare all'applicazione.
| |
sandboxType:String — Il tipo di sandbox del contenuto del browser.
| |
securityDomain:String — Il dominio di sicurezza del contenuto del browser.
| |
isHTTPS:Boolean — Indica se il contenuto del browser utilizza o meno lo schema HTTPS URL.
| |
isUserEvent:Boolean — Indica se la chiamata del browser è il risultato di un evento utente.
|
clone | () | metodo |
BROWSER_INVOKE | Costante |
public static const BROWSER_INVOKE:String = "browserInvoke"| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
La costante BrowserInvokeEvent.BROWSER_INVOKE definisce il valore della proprietà type di un oggetto BrowserInvokeEvent.
L'oggetto evento BrowserInvokeEvent ha le proprietà seguenti:
| Proprietà | Valori |
|---|---|
arguments | L'array di argomenti String passati durante la chiamata. |
sandBoxType | Una stringa che rappresenta il tipo di sandbox per il contenuto del browser (Security.APPLICATION, Security.LOCAL_TRUSTED, Security.LOCAL_WITH_FILE, Security.LOCAL_LOCAL_WITH_NETWORK o Security.REMOTE). |
securityDomain | Una stringa che rappresenta il dominio di sicurezza per il contenuto del browser (ad esempio "www.example.com"). |
isHTTPS | Indica se il contenuto del browser utilizza lo schema HTTPS URL (true) o meno (false) |
isUserEvent | Indica se la chiamata al browser è stata generata da un evento utente (sempre true in AIR 1.0). |
bubbles | No. |
cancelable | false; nessun 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