(AIR uniquement)
Packageflash.events
Classepublic class InvokeEvent
HéritageInvokeEvent 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 déclenche un événement invoke lorsque l'application est invoquée.

L'objet NativeApplication distribue toujours un événement invoke au démarrage d'une application, mais l'événement peut également être distribué à d'autres moments. Par exemple, une application en cours d'exécution déclenche un événement InvokeEvent supplémentaire lorsqu'un utilisateur active un fichier associé à l'application.

Une seule occurrence d'une application particulière peut être démarrée. Les tentatives suivantes de démarrage de l'application entraînent le déclenchement d'un nouvel événement invoke par l'objet NativeApplication de l'occurrence en cours d'exécution. L'application est chargée de gérer cet événement et d'exécuter l'action appropriée, par exemple d'ouvrir une nouvelle fenêtre d'application pour afficher les données dans un fichier.

Les objets InvokeEvent sont distribués par l'objet NativeApplication (NativeApplication.nativeApplication ). Pour recevoir des événements invoke, appelez la méthode addEventListener() de l'objet NativeApplication. Lorsqu'un écouteur d'événement s'enregistre pour un événement invoke, il reçoit également tous les événements InvokeEvent ayant eu lieu avant l'enregistrement. Ces événements précédents sont déclenchés après le retour de l'appel à la méthode addEventListener(), mais pas nécessairement avant qu'un nouvel événement invoke ait pu être déclenché après l'enregistrement. Il est donc préférable de ne pas compter sur l'ordre de déclenchement.

Voir aussi

flash.events.BrowserInvokeEvent
flash.desktop.NativeApplication


Propriétés publiques
 PropriétéDéfini par
  AIR-only arguments : Array
[lecture seule] Le tableau des arguments de chaîne transmis pendant cette invocation.
InvokeEvent
 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
  AIR-only currentDirectory : File
[lecture seule] Le répertoire qui doit être utilisé pour résoudre des chemins relatifs dans le tableau d'arguments.
InvokeEvent
 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
 Inheritedprototype : Object
[statique] Référence à l'objet prototype d'un objet de classe ou fonction.
Object
  AIR-only reason : String
[lecture seule] La raison de cet InvokeEvent.
InvokeEvent
 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 InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")
La fonction de constructeur pour la classe InvokeEvent.
InvokeEvent
  
Crée une copie de cet événement.
InvokeEvent
 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
Indique si la propriété spécifiée d'un objet est définie.
Object
 Inherited
Vérifie si la méthode preventDefault() a été appelée pour l'événement.
Event
 Inherited
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
Annule le comportement par défaut d'un événement si cette opération est possible.
Event
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Bloque le traitement des écouteurs d'événement dans le nœud actuel et les suivants dans le flux d'événements.
Event
 Inherited
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
Renvoie une chaîne répertoriant toutes les propriétés de l'objet Event.
Event
 Inherited
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
 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
  AIR-only INVOKE : String = "invoke"
[statique] La constante InvokeEvent.INVOKE définit la valeur de la propriété type de l'objet InvokeEvent.
InvokeEvent
 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]

Versions du moteur d'exécution: AIR 1.0

Le tableau des arguments de chaîne transmis pendant cette invocation. S'il s'agit d'une invocation de ligne de commande, le tableau contient les arguments de la ligne de commande excluant le nom du processus.

Remarque : lorsque vous sélectionnez et ouvrez plusieurs fichiers dans Mac® OS X, AIR distribue un seul événement invoke contenant les noms de tous les fichiers sélectionnés dans le tableau arguments. Cependant, sous Windows® et Linux, AIR distribue un événement invoke distinct pour chaque fichier sélectionné contenant uniquement ce nom de fichier dans le tableau arguments.



Implémentation
    public function get arguments():Array
AIR-only currentDirectorypropriété 
currentDirectory:File  [lecture seule]

Versions du moteur d'exécution: AIR 1.0

Répertoire qui doit être utilisé pour résoudre des chemins relatifs dans le tableau arguments.

Si vous lancez une application à partir de la ligne de commande, cette propriété est généralement définie sur le répertoire de travail actuel du shell de ligne de commande à partir duquel l'application a été démarrée. Si vous lancez une application depuis le shell GUI, il s'agit généralement de la racine du système de fichiers.



Implémentation
    public function get currentDirectory():File
AIR-only reasonpropriété 
reason:String  [lecture seule]

Versions du moteur d'exécution: AIR 1.5.1

La raison de cet InvokeEvent. Cette propriété indique que l'application a été lancée manuellement par l'utilisateur ou automatiquement lors de la connexion. Les valeurs possibles sont énumérées en tant que constantes dans la classe InvokeEventReason :

Constante InvokeEventReasonSignification
LOGIN Démarrée automatiquement lors de la connexion.
STANDARD Démarrée manuellement par l'utilisateur.



Implémentation
    public function get reason():String

Voir aussi

Détails du constructeur
AIR-only InvokeEvent()Constructeur
public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")

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

Fonction de constructeur pour la classe InvokeEvent.

Paramètres
type:String — Type de l'événement, accessible en tant que Event.type.
 
bubbles:Boolean (default = false) — Définissez sur false pour un objet InvokeEvent.
 
cancelable:Boolean (default = false) — Définissez sur false pour un objet InvokeEvent.
 
dir:File (default = null) — Le répertoire qui doit être utilisé pour résoudre des chemins relatifs dans le tableau arguments.
 
argv:Array (default = null) — Un tableau d'arguments (chaînes) à transmettre à l'application.
 
reason:String (default = "standard")
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 INVOKEConstante
public static const INVOKE:String = "invoke"

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

La constante InvokeEvent.INVOKE définit la valeur de la propriété type de l'objet InvokeEvent.

L'objet InvokeEvent possède les propriétés suivantes :

PropriétésValeurs
arguments Tableau des arguments de chaîne transmis pendant cette invocation.
currentDirectory un objet Objet File représentant le répertoire à utiliser pour résoudre des chemins relatifs dans le tableau d'arguments.
bubbles false.
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