(AIR uniquement)
Packageflash.events
Classepublic class BrowserInvokeEvent
HéritageBrowserInvokeEvent Inheritance Event Inheritance Object

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

L'objet NativeApplication d'une application AIR distribue un événement 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.

Voir aussi

flash.events.InvokeEvent
flash.desktop.NativeApplication

Propriétés publiques
 PropriétéDéfini par
  AIR-only arguments : Array
[lecture seule] Un tableau d'arguments (chaînes) à transmettre à l'application.
BrowserInvokeEvent
 Inheritedbubbles : Boolean
[lecture seule] Indique si un événement peut se propager vers le haut (bubbling).
Event
 Inheritedcancelable : Boolean
[lecture seule] Indique si le comportement associé à l'événement peut être annulé.
Event
 Inheritedconstructor : Object
Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.
Object
 InheritedcurrentTarget : Object
[lecture seule] L'objet qui traite activement l'objet Event avec un écouteur d'événements.
Event
 InheritedeventPhase : uint
[lecture seule] Phase actuelle du flux d'événements.
Event
  AIR-only isHTTPS : Boolean
[lecture seule] Indique si le contenu dans le navigateur utilise le schéma URL HTTPS (true) ou non (false).
BrowserInvokeEvent
  AIR-only isUserEvent : Boolean
[lecture seule] Indique si l'invocation du navigateur a entraîné un événement user (tel qu'un clic de souris).
BrowserInvokeEvent
 Inheritedprototype : Object
[statique] Référence à l'objet prototype d'un objet de classe ou fonction.
Object
  AIR-only sandboxType : String
[lecture seule] Le type de sandbox pour le contenu dans le navigateur.
BrowserInvokeEvent
  AIR-only 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
 Inheritedtarget : Object
[lecture seule] Cible de l'événement.
Event
 Inheritedtype : String
[lecture seule] Type d'événement.
Event
Méthodes publiques
 MéthodeDéfini par
  
AIR-only 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
  
AIR-only clone():Event
Crée une copie de cet événement.
BrowserInvokeEvent
 Inherited
formatToString(className:String, ... arguments):String
Fonction d'un utilitaire permettant d'implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées.
Event
 Inherited
hasOwnProperty(name:String):Boolean
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
isDefaultPrevented():Boolean
Vérifie si la méthode preventDefault() a été appelée pour l'événement.
Event
 Inherited
isPrototypeOf(theClass:Object):Boolean
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
 Inherited
preventDefault():void
Annule le comportement par défaut d'un événement si cette opération est possible.
Event
 Inherited
propertyIsEnumerable(name:String):Boolean
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
stopImmediatePropagation():void
Bloque le traitement des écouteurs d'événement dans le nœud actuel et les suivants dans le flux d'événements.
Event
 Inherited
stopPropagation():void
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
 Inherited
toString():String
Renvoie une chaîne répertoriant toutes les propriétés de l'objet Event.
Event
 Inherited
valueOf():Object
Renvoie la valeur primitive de l'objet spécifié.
Object
Constantes publiques
 ConstanteDéfini par
 InheritedACTIVATE : String = "activate"
[statique] La constante ACTIVATE définit la valeur de la propriété type d'un objet événement activate.
Event
 InheritedADDED : String = "added"
[statique] La constante Event.ADDED définit la valeur de la propriété type d'un objet événement added.
Event
 InheritedADDED_TO_STAGE : String = "addedToStage"
[statique] La constante Event.ADDED_TO_STAGE définit la valeur de la propriété type d'un objet d'événement addedToStage.
Event
  AIR-only BROWSER_INVOKE : String = "browserInvoke"
[statique] La constante BrowserInvokeEvent.BROWSER_INVOKE définit la valeur de la propriété type d'un objet BrowserInvokeEvent.
BrowserInvokeEvent
 InheritedCANCEL : String = "cancel"
[statique] La constante Event.CANCEL définit la valeur de la propriété type d'un objet événement cancel.
Event
 InheritedCHANGE : String = "change"
[statique] La constante Event.CHANGE définit la valeur de la propriété type de l'objet d'événement change.
Event
 InheritedCLEAR : String = "clear"
[statique] La constante Event.CLEAR définit la valeur de la propriété type d'un objet événement clear.
Event
 InheritedCLOSE : String = "close"
[statique] La constante Event.CLOSE définit la valeur de la propriété type d'un objet événement close.
Event
 InheritedAIR-only CLOSING : String = "closing"
[statique] La constante Event.CLOSING définit la valeur de la propriété type d'un objet événement closing.
Event
 InheritedCOMPLETE : String = "complete"
[statique] La constante Event.COMPLETE définit la valeur de la propriété type d'un objet événement complete.
Event
 InheritedCONNECT : String = "connect"
[statique] La constante Event.CONNECT définit la valeur de la propriété type d'un objet événement connect.
Event
 InheritedCOPY : String = "copy"
[statique] Définit la valeur de la propriété type d'un objet d'événement copy.
Event
 InheritedCUT : String = "cut"
[statique] Définit la valeur de la propriété type d'un objet d'événement cut.
Event
 InheritedDEACTIVATE : String = "deactivate"
[statique] La constante Event.DEACTIVATE définit la valeur de la propriété type d'un objet événement deactivate.
Event
 InheritedDISPLAYING : String = "displaying"
[statique] La constante Event.DISPLAYING définit la valeur de la propriété type d'un objet événement displaying.
Event
 InheritedENTER_FRAME : String = "enterFrame"
[statique] La constante Event.ENTER_FRAME définit la valeur de la propriété type d'un objet événement enterFrame.
Event
 InheritedEXIT_FRAME : String = "exitFrame"
[statique] La constante Event.EXIT_FRAME définit la valeur de la propriété type d'un objet événement exitFrame.
Event
 InheritedAIR-only EXITING : String = "exiting"
[statique] La constante Event.EXITING définit la valeur de la propriété type de l'objet d'événement exiting.
Event
 InheritedFRAME_CONSTRUCTED : String = "frameConstructed"
[statique] La constante Event.FRAME_CONSTRUCTED définit la valeur de la propriété type d'un objet événement frameConstructed.
Event
 InheritedFULLSCREEN : String = "fullScreen"
[statique] La constante Event.FULL_SCREEN définit la valeur de la propriété type d'un objet événement fullScreen.
Event
 InheritedAIR-only HTML_BOUNDS_CHANGE : String = "htmlBoundsChange"
[statique] La constante Event.HTML_BOUNDS_CHANGE définit la valeur de la propriété type d'un objet événement htmlBoundsChange.
Event
 InheritedAIR-only HTML_DOM_INITIALIZE : String = "htmlDOMInitialize"
[statique] La constante Event.HTML_DOM_INITIALIZE définit la valeur de la propriété type d'un objet événement htmlDOMInitialize.
Event
 InheritedAIR-only HTML_RENDER : String = "htmlRender"
[statique] La constante Event.HTML_RENDER définit la valeur de la propriété type d'un objet événement htmlRender.
Event
 InheritedID3 : String = "id3"
[statique] La constante Event.ID3 définit la valeur de la propriété type d'un objet événement id3.
Event
 InheritedINIT : String = "init"
[statique] La constante Event.INIT définit la valeur de la propriété type d'un objet événement init.
Event
 InheritedAIR-only LOCATION_CHANGE : String = "locationChange"
[statique] La constante Event.LOCATION_CHANGE définit la valeur de la propriété type d'un objet événement locationChange.
Event
 InheritedMOUSE_LEAVE : String = "mouseLeave"
[statique] La constante Event.MOUSE_LEAVE définit la valeur de la propriété type d'un objet événement mouseLeave.
Event
 InheritedAIR-only NETWORK_CHANGE : String = "networkChange"
[statique] La constante Event.NETWORK_CHANGE définit la valeur de la propriété type d'un objet événement networkChange.
Event
 InheritedOPEN : String = "open"
[statique] La constante Event.OPEN définit la valeur de la propriété type d'un objet événement open.
Event
 InheritedPASTE : String = "paste"
[statique] La constante Event.PASTE définit la valeur de la propriété type d'un objet événement paste.
Event
 InheritedREMOVED : String = "removed"
[statique] La constante Event.REMOVED définit la valeur de la propriété type d'un objet événement removed.
Event
 InheritedREMOVED_FROM_STAGE : String = "removedFromStage"
[statique] La constante Event.REMOVED_FROM_STAGE définit la valeur de la propriété type d'un objet événement removedFromStage.
Event
 InheritedRENDER : String = "render"
[statique] La constante Event.RENDER définit la valeur de la propriété type d'un objet événement render.
Event
 InheritedRESIZE : String = "resize"
[statique] La constante Event.RESIZE définit la valeur de la propriété type d'un objet événement resize.
Event
 InheritedSCROLL : String = "scroll"
[statique] La constante Event.SCROLL définit la valeur de la propriété type d'un objet événement scroll.
Event
 InheritedSELECT : String = "select"
[statique] La constante Event.SELECT définit la valeur de la propriété type d'un objet événement select.
Event
 InheritedSELECT_ALL : String = "selectAll"
[statique] La constante Event.SELECT_ALL définit la valeur de la propriété type d'un objet événement selectAll.
Event
 InheritedSOUND_COMPLETE : String = "soundComplete"
[statique] La constante Event.SOUND_COMPLETE définit la valeur de la propriété type d'un objet événement soundComplete.
Event
 InheritedTAB_CHILDREN_CHANGE : String = "tabChildrenChange"
[statique] La constante Event.TAB_CHILDREN_CHANGE définit la valeur de la propriété type d'un objet événement tabChildrenChange.
Event
 InheritedTAB_ENABLED_CHANGE : String = "tabEnabledChange"
[statique] La constante Event.TAB_ENABLED_CHANGE définit la valeur de la propriété type d'un objet événement tabEnabledChange.
Event
 InheritedTAB_INDEX_CHANGE : String = "tabIndexChange"
[statique] La constante Event.TAB_INDEX_CHANGE définit la valeur de la propriété type d'un objet événement tabIndexChange.
Event
 InheritedUNLOAD : String = "unload"
[statique] La constante Event.UNLOAD définit la valeur de la propriété type d'un objet événement unload.
Event
 InheritedAIR-only USER_IDLE : String = "userIdle"
[statique] La constante Event.USER_IDLE définit la valeur de la propriété type d'un objet événement userIdle.
Event
 InheritedAIR-only USER_PRESENT : String = "userPresent"
[statique] La constante Event.USER_PRESENT définit la valeur de la propriété type d'un objet événement userPresent.
Event
Détails de la propriété
AIR-only argumentspropriété
arguments:Array  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

Un tableau d'arguments (chaînes) à transmettre à l'application.



Implémentation
    public function get arguments():Array
AIR-only isHTTPSpropriété 
isHTTPS:Boolean  [lecture seule]

Version du langage: ActionScript 3.0
Versions du moteur d'exécution: AIR 1.0

Indique si le contenu dans le navigateur utilise le schéma URL HTTPS (true) ou non (false ).



Implémentation
    public function get isHTTPS():Boolean
AIR-only isUserEventproprié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
AIR-only sandboxTypeproprié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 :



Implémentation
    public function get sandboxType():String

Voir aussi

flash.system.Security.sandboxType
AIR-only securityDomainproprié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
Détails du constructeur
AIR-only 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.

Paramètres
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.
Détails de la méthode
AIR-only clone()méthode
override public function clone():Event

Versions du moteur d'exécution: AIR 1.0

Crée une copie de cet événement.

Valeur renvoyée
Event — Copie de l'événement.
Détails de la constante
AIR-only BROWSER_INVOKEConstante
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ésValeurs
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 Objet NativeApplication.

Voir aussi

flash.desktop.NativeApplication



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Thu Jan 8 2009, 03:00 AM -08:00