| Package | flash.events |
| Classe | public class BrowserInvokeEvent |
| Héritage | BrowserInvokeEvent  Event Object |
| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0 |
browserInvoke lorsque l’application est invoquée à la suite de l’utilisation de la fonction d’invocation du navigateur par un fichier SWF dans le navigateur. L’objet NativeApplication distribue également un événement browserInvoke lorsqu’un utilisateur instancie la fonction d’installation continue dans le navigateur et que le fichier SWF dans le navigateur transmet un tableau au paramètre arguments de la méthode launchApplication() du fichier air.swf (pour plus de détails, voir « Distribution, installation et exécution des applications AIR » dans le guide du développeur AIR).
L’invocation d’un navigateur n’est autorisée que si l’application spécifie les éléments suivants dans son fichier descripteur :
<allowBrowserInvocation>true</allowBrowserInvocation>
Si l’application n’est pas en cours d’exécution, l’objet NativeApplication distribue à la fois un événement InvokeEvent et un événement browserInvoke lors du démarrage depuis le navigateur. Autrement, si l’application est déjà en cours d’exécution, l’objet NativeApplication distribue uniquement un événement browserInvoke lors du démarrage depuis le navigateur.
Si l’application est démarrée à la suite d’une installation continue depuis le navigateur (l’utilisateur ayant choisi de démarrer après l’installation), l’objet NativeApplication distribue un événement BrowserInvoke uniquement si des arguments ont été transmis (via le fichier SWF dans le navigateur transmettant un tableau au paramètre arguments de la méthode installApplication() du fichier air.swf). Pour plus de détails, voir « Distribution, installation et exécution des applications AIR » dans le guide du développeur AIR.
A l’instar des événements InvokeEvent, les événements browserInvokeEvent sont distribués par l’objet NativeApplication (NativeApplication.nativeApplication). Pour recevoir des événements browserInvoke, appelez la méthode addEventListener() de l’objet NativeApplication. Lorsqu’un écouteur d’événement s’enregistre pour un événement browserInvoke, il reçoit également tous les événements browserInvoke ayant eu lieu avant l’enregistrement. Ceux-ci sont distribués après le renvoi de l’appel à addEventListener(), mais pas forcément avant d’autres événements browserInvoke qui pourraient être reçus après l’enregistrement. Ceci vous permet de gérer des événements browserInvoke qui ont eu lieu avant l’exécution de votre code d’initialisation (lorsque l’application a été invoquée au départ depuis le navigateur, par exemple). Si vous ajoutez un écouteur d’événement ultérieurement dans l’exécution (après l’initialisation de l’application), il continue à recevoir tous les événements browserInvoke qui ont eu lieu depuis le démarrage de l’application.
Eléments de l’API associés
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
| arguments : Array [lecture seule]
Un tableau d’arguments (chaînes) à transmettre à l’application. | BrowserInvokeEvent | ||
 | bubbles : Boolean [lecture seule]
Indique si un événement peut se propager vers le haut (bubbling). | Event | |
| cancelable : Boolean [lecture seule]
Indique si le comportement associé à l’événement peut être évité. | Event | |
| constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| currentTarget : Object [lecture seule]
L’objet qui traite activement l’objet Event avec un écouteur d’événements. | Event | |
| eventPhase : uint [lecture seule]
Phase actuelle du flux d’événements. | Event | |
| isHTTPS : Boolean [lecture seule]
Indique si le contenu dans le navigateur utilise le schéma URL HTTPS (true) ou non (false). | BrowserInvokeEvent | ||
| isUserEvent : Boolean [lecture seule]
Indique si l’invocation du navigateur a entraîné un événement user (tel qu’un clic de souris). | BrowserInvokeEvent | ||
| sandboxType : String [lecture seule]
Le type de sandbox pour le contenu dans le navigateur. | BrowserInvokeEvent | ||
| securityDomain : String [lecture seule]
Le domaine de sécurité pour le contenu dans le navigateur, tel que« www.adobe.com » ou « www.example.org ». | BrowserInvokeEvent | ||
| target : Object [lecture seule]
Cible de l’événement. | Event | |
| type : String [lecture seule]
Type d’événement. | Event | |
| Méthode | Défini par | ||
|---|---|---|---|
BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean)
La fonction de constructeur pour la classe BrowserInvokeEvent. | BrowserInvokeEvent | ||
[override]
Crée une copie de cet événement. | BrowserInvokeEvent | ||
|
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Vérifie si la méthode preventDefault() a été appelée pour l’événement. | Event | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Annule le comportement par défaut d’un événement si cette opération est possible. | Event | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements. | Event | |
|
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements. | Event | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie une chaîne répertoriant toutes les propriétés de l’objet Event. | Event | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
| Constante | Défini par | ||
|---|---|---|---|
| BROWSER_INVOKE : String = "browserInvoke" [statique]
La constante BrowserInvokeEvent.BROWSER_INVOKE définit la valeur de la propriété type d’un objet BrowserInvokeEvent. | BrowserInvokeEvent | ||
arguments | propriété |
isHTTPS | propriété |
isUserEvent | propriété |
isUserEvent:Boolean [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0 |
Indique si l’invocation du navigateur a entraîné un événement user (tel qu’un clic de souris). Dans AIR 1.0, ceci est toujours défini sur true ; AIR requiert un événement user pour initier un appel à la fonction d’invocation du navigateur.
Implémentation
public function get isUserEvent():Boolean sandboxType | propriété |
sandboxType:String [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0 |
Le type de sandbox pour le contenu dans le navigateur. Cette valeur peut être :
Security.APPLICATION— Le contenu se trouve dans le sandbox de sécurité de l’application.Security.LOCAL_TRUSTED— Le contenu est dans le sandbox de sécurité local approuvé.Security.LOCAL_WITH_FILE— Le contenu se trouve dans le sandbox de sécurité local avec système de fichiers.Security.LOCAL_WITH_NETWORK— Le contenu se trouve dans le sandbox de sécurité local avec mise en réseau.Security.REMOTE— Le contenu se trouve dans le domaine distant (réseau)
Implémentation
public function get sandboxType():StringEléments de l’API associés
securityDomain | propriété |
securityDomain:String [lecture seule] | Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0 |
Le domaine de sécurité pour le contenu dans le navigateur, tel que "www.adobe.com" ou "www.example.org". Cette propriété est définie uniquement pour le contenu présent dans le sandbox de sécurité distant (pour le contenu d’un domaine réseau) et non pour le contenu présent dans un sandbox de sécurité d’application ou local.
Implémentation
public function get securityDomain():String BrowserInvokeEvent | () | Constructeur |
public function BrowserInvokeEvent(type:String, bubbles:Boolean, cancelable:Boolean, arguments:Array, sandboxType:String, securityDomain:String, isHTTPS:Boolean, isUserEvent:Boolean)| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0 |
La fonction de constructeur pour la classe BrowserInvokeEvent. Généralement, les développeurs n’appellent pas le constructeur BrowserInvokeEvent() directement. Seul le moteur d’exécution doit créer un objet BrowserInvokeEvent.
type:String — Type de l’événement, accessible en tant que Event.type.
| |
bubbles:Boolean — Définissez sur false pour un objet BrowserInvokeEvent.
| |
cancelable:Boolean — Définissez sur false pour un objet BrowserInvokeEvent.
| |
arguments:Array — Un tableau d’arguments (chaînes) à transmettre à l’application.
| |
sandboxType:String — Le type de sandbox pour le contenu dans le navigateur.
| |
securityDomain:String — Le domaine de sécurité pour le contenu dans le navigateur.
| |
isHTTPS:Boolean — Indique si le contenu dans le navigateur utilise le schéma URL HTTPS ou non.
| |
isUserEvent:Boolean — Indique si l’invocation du navigateur résultait d’un événement user.
|
clone | () | méthode |
BROWSER_INVOKE | Constante |
public static const BROWSER_INVOKE:String = "browserInvoke"| Version du langage: | ActionScript 3.0 |
| Versions du moteur d’exécution: | AIR 1.0 |
La constante BrowserInvokeEvent.BROWSER_INVOKE définit la valeur de la propriété type d’un objet BrowserInvokeEvent.
L’objet BrowserInvokeEvent possède les propriétés suivantes :
| Propriétés | Valeurs |
|---|---|
arguments | Tableau des arguments de chaîne transmis pendant cette invocation. |
sandBoxType | Chaîne représentant le type de sandbox pour le contenu du navigateur (Security.APPLICATION, Security.LOCAL_TRUSTED, Security.LOCAL_WITH_FILE, Security.LOCAL_LOCAL_WITH_NETWORK ou Security.REMOTE). |
securityDomain | Une chaîne représentant le domaine de sécurité pour le contenu dans le navigateur (tel que "www.example.com"
). |
isHTTPS | Indique si le contenu du navigateur utilise le schéma URL HTTPS (true) ou non (false) |
isUserEvent | Indique si l’invocation du navigateur a résulté d’un événement user (toujours true dans AIR 1.0). |
bubbles | N° |
cancelable | false ; Il n’existe aucun comportement par défaut à annuler. |
currentTarget | Indique l’objet qui traite activement l’objet InvokeEvent avec un écouteur d’événements. |
target | Toujours l’objet NativeApplication. |
Eléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z