Package | flash.events |
Classe | public class InvokeEvent |
Héritage | InvokeEvent Event Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0 |
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.
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
arguments : Array [lecture seule]
Tableau des arguments de chaîne transmis pendant cette invocation. | InvokeEvent | ||
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 | ||
currentDirectory : File [lecture seule]
Le répertoire qui doit être utilisé pour résoudre des chemins relatifs dans le tableau d’arguments. | InvokeEvent | ||
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 | ||
reason : String [lecture seule]
La raison de cet InvokeEvent. | InvokeEvent | ||
target : Object [lecture seule]
Cible de l’événement. | Event | ||
type : String [lecture seule]
Type d’événement. | Event |
Méthode | Défini par | ||
---|---|---|---|
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 | ||
[override]
Crée une copie de cet événement. | InvokeEvent | ||
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 | ||
---|---|---|---|
INVOKE : String = "invoke" [statique]
La constante InvokeEvent.INVOKE définit la valeur de la propriété type de l’objet InvokeEvent. | InvokeEvent |
arguments | proprié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.
Sur les plates-formes mobiles, cette propriété contient l’ensemble d’options avec lequel l’application a été lancée et non les arguments de la ligne de commande. De plus, sur les plates-formes mobiles, lorsque la propriété reason
est définie sur InvokeEventReason.OPEN_URL
, le contenu des arguments Array varient, comme suit :
- Une autre application ou un autre navigateur appelle l’application avec une URL personnalisée (iOS et Android) :
arguments iOS Android InvokeEvent.arguments.length
3 2 InvokeEvent.arguments[0]
url url InvokeEvent.arguments[1]
source app id action id InvokeEvent.arguments[2]
null S/O - Le système appelle l’application pour ouvrir un type de fichier associé (iOS et Android) :
arguments iOS Android InvokeEvent.arguments.length
3 2 InvokeEvent.arguments[0]
url url InvokeEvent.arguments[1]
null action id InvokeEvent.arguments[2]
null S/O - Une autre application appelle l’application à l’aide du contrôleur d’interaction de document (iOS uniquement) :
arguments iOS InvokeEvent.arguments.length
3 InvokeEvent.arguments[0]
url InvokeEvent.arguments[1]
source app id InvokeEvent.arguments[2]
annotation
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
currentDirectory | proprié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
reason | propriété |
reason:String
[lecture seule] Versions du moteur d’exécution: | AIR 1.5.1 |
La raison de cet InvokeEvent. Cette propriété indique si 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 InvokeEventReason | Signification |
---|---|
LOGIN | Démarrée automatiquement lors de la connexion. |
NOTIFICATION | Lancée en réponse à une notification (iOS uniquement). |
OPEN_URL | Lancée parce que l’application a été appelée par une autre application. |
STANDARD | Lancée pour toute autre raison. |
Remarque : sur les plates-formes mobiles, la propriété reason
n’est jamais définie sur LOGIN
.
Implémentation
public function get reason():String
Eléments de l’API associés
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 |
La fonction de constructeur pour la classe InvokeEvent.
Paramètrestype: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 ) — 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 ") — Cause de l’événement : InvokeEventReason.LOGIN , InvokeEventReason.STANDARD , InvokeEventReason.OPEN_URL ou InvokeEventReason.NOTIFICATION . (Ce paramètre est disponible à partir de la version 1.5.1 d’AIR. OPEN_URL et NOTIFICATION sont disponibles à partir de la version 3.5 d’AIR.)
|
Eléments de l’API associés
clone | () | méthode |
INVOKE | Constante |
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és | Valeurs |
---|---|
arguments | Tableau des arguments de chaîne transmis pendant cette invocation. |
currentDirectory | Objet File représentant le répertoire à utiliser pour résoudre des chemins relatifs dans le tableau d’arguments. |
reason | Code indiquant si l’événement invoke a été distribué parce que l’application a démarré automatiquement à la connexion (InvokeEventReason.LOGIN ) ou a démarré en réponse à une notification à distance (InvokeEventReason.NOTIFICATION , iOS uniquement), parce que l’application a été appelée par une autre application (InvokeEventReason.OPEN_URL ), ou pour tout autre raison (InvokeEventReason.STANDARD ). Disponible depuis la version 1.5.1 d’AIR. |
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 NativeApplication. |
Eléments de l’API associés
Tue Jun 12 2018, 09:30 AM Z