Fenêtre de l'application active.

Si la fenêtre du bureau active n'appartient pas à cette application ou s'il n'y a pas de fenêtre active, la propriété activeWindow est null.

Contenu du fichier descripteur de cette application AIR.

var appDescriptor:XML = NativeApplication.nativeApplication.applicationDescriptor;
var ns:Namespace = appDescriptor.namespace();
var appCopyright:String = appDescriptor.ns::copyright;
var appVersion:String = appDescriptor.ns::version;
trace("appId:", appCopyright);
trace("version:", appVersion);

ID d'application de cette application.

La valeur de cet ID est définie dans le fichier descripteur de l'application.

Spécifie si l'application doit se fermer automatiquement lorsque toutes les fenêtres ont été fermées.

Lorsque autoExit est true, par défaut, l'application s'interrompt lorsque toutes ses fenêtres ont été fermées. Les événements exiting et exit sont tous deux déclenchés. Lorsque autoExit est false, vous devez appeler NativeApplication.nativeApplication.exit() pour fermer l'application.

Icône de l'application.

Utilisez NativeApplication.supportsDockIcon et NativeApplication.supportsSystemTrayIcon pour déterminer la classe icon. Le type sera l'une des sous-classes d'InteractiveIcon. Sous Mac^® OS X, NativeApplication.icon est un objet de type DockIcon. Sous Windows^®, NativeApplication.icon est un objet de type SystemTrayIcon. Sous Linux, l'icône d'une application n'est pas toujours prise en charge. Le cas échéant, la propriété icon est null.

L'objet icon est créé automatiquement mais n'est pas initialisé avec les données d'image. Sous certains systèmes d'exploitation, tels que Mac OS X, une image par défaut est fournie. Avec d'autres, tels que Windows, l'icône n'est pas affichée à moins que des données d'image ne lui soient affectées. Pour affecter une image d'icône, définissez la propriété icon.bitmaps avec un tableau contenant au moins un objet BitmapData. Si le tableau comprend plusieurs objets BitmapData, le système d'exploitation choisit l'image dont la taille est la plus proche des dimensions d'affichage de l'icône, en la mettant à l'échelle si nécessaire.

Voir aussi

Nombre de secondes devant s'écouler sans saisie du clavier ou action de la souris avant qu'un événement userIdle ne soit distribué.

Par défaut, le seuil d'inactivité est de 300 secondes (5 minutes).

Voir aussi

Menu de l'application.

Les menus de l'application sont pris en charge lorsque NativeApplication.nativeApplication.supportsMenu est true. Les menus d'application ne sont pas pris en charge par tous les systèmes d'exploitation. Par exemple, ils sont pris en charge par Mac OS X, mais pas par Windows ou Linux. L'affectation d'un objet NativeMenu à cette propriété lorsque NativeApplication.nativeApplication.supportsMenu est false est autorisée, mais n'a aucun effet.

Remarque : sous Mac OS X, la propriété menu fait référence au menu d'application par défaut fourni par le système d'exploitation. Vous pouvez modifier la structure du menu existant en ajoutant et en supprimant des éléments et des sous-menus, et en ajoutant des écouteurs d'événement. Vous pouvez également remplacer entièrement les menus par défaut en affectant un nouvel objet NativeMenu à cette propriété menu.

Voir aussi

Occurrence singleton de l'objet NativeApplication.

Tableau contenant toutes les fenêtres natives et ouvertes de cette application.

ID d'éditeur de cette application.

La valeur de cet ID est définie dans le fichier publisherid de l'application, généré au moment de l'installation à partir de la chaîne de certificat utilisée pour signer l'application.

Niveau de correctif du moteur d'exécution hébergeant cette application.

Numéro de version du moteur d'exécution hébergeant cette application.

Spécifie si cette application se lance automatiquement dès que l'utilisateur actuel se connecte.

La propriété startAtLogin reflète l'état du mécanisme défini par le système d'exploitation pour indiquer qu'une application doit démarrer automatiquement lorsqu'un utilisateur se connecte. L'utilisateur peut modifier l'état manuellement via l'interface utilisateur du système d'exploitation. Cette propriété reflète l'état actuel, qu'il ait été modifié pour la dernière fois par l'application AIR ou par le système d'exploitation.

Indique si AIR prend en charge les icônes du Dock de l'application dans le système d'exploitation actuel.

Si true, la propriété NativeApplication.icon est de type DockIcon.

Mac OS X et diverses interfaces de Linux^® fournissent un « Dock » d'applications contenant des icônes qui permettent d'exécuter les applications fréquemment utilisées.

Voir aussi

Spécifie si le système d'exploitation actuel prend en charge une barre de menus d'application globale.

Lorsque sa valeur est true, la propriété NativeApplication.menu peut être utilisée pour définir (ou accéder à) un menu d'application natif.

Voir aussi

Spécifie si AIR prend en charge les icônes de la barre d'état système dans le système d'exploitation actuel.

Si true, la propriété NativeApplication.icon est de type SystemTrayIcon.

Remarque : sous Windows, la zone d'état système de la barre des tâches est officiellement appelée Zone de notification.

Voir aussi

Durée écoulée, en secondes, depuis la dernière entrée de la souris ou du clavier.

Voir aussi

Active cette application.

Selon les circonstances déterminées par le système d'exploitation, cette méthode n'active pas d'application. La plupart des systèmes d'exploitation limitent la capacité d'une application à s'activer elle-même pour qu'elle ne puisse pas empêcher l'utilisateur d'employer d'autres applications, accidentellement ou non.

Si le système d'exploitation autorise l'activation, la fenêtre spécifiée est activée et ramenée au premier plan, c'est-à-dire par-dessus celles des autres applications. (Si le paramètre window est null, une fenêtre visible de cette application est activée.)

La méthode activate() n'a aucun effet si l'application n'a pas de fenêtre visible.

L'opération active est synchrone.

Paramètres

Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. Vous pouvez enregistrer les écouteurs d’événement dans tous les nœuds de la liste d’affichage pour un type spécifique d’événement, de phase et de priorité.

Après l'enregistrement d'un écouteur d'événements, vous ne pouvez plus modifier sa priorité par d'autres appels de addEventListener(). Pour modifier la priorité d'un écouteur, vous devez d'abord appeler removeListener(). Vous pouvez ensuite réenregistrer l'écouteur avec le nouveau niveau de priorité.

N'oubliez pas qu'une fois l'écouteur enregistré, tous les prochains appels de addEventListener() avec une valeur type ou useCapture différente entraîneront la création d'un autre enregistrement d'écouteur. Si, par exemple, vous enregistrez un écouteur dans lequel la propriété useCapture est définie sur true, il écoute uniquement pendant la phase de capture. Si vous appelez addEventListener() à l’aide du même objet écouteur, mais en définissant useCapture sur false, vous obtenez deux écouteurs distincts : l'un qui écoute pendant la phase de capture et l’autre qui écoute pendant les phases cible et de propagation vers le haut (bubbling).

Il est impossible d'enregistrer un écouteur d'événement pour la phase cible ou la phase de propagation vers le haut (bubbling) uniquement. Ces deux phases sont associées pendant l'enregistrement car la propagation vers le haut (bubbling) s'applique uniquement aux ancêtres du nœud cible.

Si vous n'avez plus besoin d'un écouteur d'événements, supprimez-le en appelant removeEventListener(), afin d'éviter tout problème de mémoire. Les objets associés à des écouteurs d'événement enregistrés ne sont pas automatiquement supprimés de la mémoire, car le nettoyeur de mémoire n'efface pas les objets auxquels il est toujours fait référence.

Lors de la copie d'une occurrence d'EventDispatcher, les écouteurs d'événement qui lui sont associés ne sont pas pris en compte. (Si votre nouveau nœud nécessite un écouteur d'événements, vous devez associer celui-ci après la création du nœud.) Toutefois, si vous déplacez une occurrence d'EventDispatcher, les écouteurs d'événement qui lui sont associés la suivent.

Si un écouteur d'événement est enregistré sur un nœud alors qu'un événement est en cours de traitement sur ce nœud, l'écouteur n'est pas déclenché pendant la phase actuelle, mais il peut l'être pendant une phase ultérieure du flux d'événements, telle que la phase de propagation vers le haut (bubbling).

Si un écouteur d'événement est supprimé d'un nœud sur lequel un événement est en cours de traitement, il est cependant déclenché par les actions en cours. Une fois supprimé, l'écouteur d'événement n'est plus jamais appelé (à moins d'être réenregistré à des fins de traitement ultérieur).

Paramètres

function(evt:Event):void

Invoque une commande de suppression interne sur l'objet d'affichage qui a le focus.

Cet appel de fonction est ignoré si l'objet qui a le focus n'implémente pas la commande. Seuls les objets d'affichage descendant des classes TextField ou HTMLLoader peuvent implémenter cette commande actuellement.

Remarque : la commande clear() supprime le texte sélectionné. Si rien n'est sélectionné, l'ensemble du texte n'est pas supprimé.

Invoque une commande de copie interne sur l'objet d'affichage qui a le focus.

Cet appel de fonction est ignoré si le composant n'implémente pas la commande. Seuls les objets d'affichage descendant des classes TextField ou HTMLLoader peuvent implémenter cette commande actuellement.

Invoque une commande de coupe interne sur l'objet d'affichage qui a le focus.

Cet appel de fonction est ignoré si le composant n'implémente pas la commande. Seuls les objets d'affichage descendant des classes TextField ou HTMLLoader peuvent implémenter ces commandes actuellement.

Distribue un événement dans le flux d'événements. La cible de l'événement est l'objet EventDispatcher sur lequel la méthode dispatchEvent() est appelée.

Paramètres

Met fin à cette application.

L'appel à la méthode exit() renverra ; la séquence de fermeture ne commence pas avant la fin du code en cours d'exécution (par exemple un gestionnaire d'événement en cours). Les opérations asynchrones en attente sont annulées et peuvent ou non être terminées.

Notez qu'aucun événement exiting n'est déclenché. Si un événement exiting est requis par la logique de l'application, appelez NativeApplication.nativeApplication.dispatchEvent() en transmettant un objet Event de type exiting. De même, aucun événement closing ou close n'est déclenché avant la fermeture des fenêtres de l'application. Si des fenêtres doivent être averties avant la fermeture de votre application, vous pouvez déclencher des événements closing pour chaque fenêtre ouverte. Si un événement close est requis pour une fenêtre, appelez la méthode close() de la fenêtre avant la fermeture.

Paramètres

Récupère l'application par défaut pour ouvrir les fichiers présentant l'extension spécifiée.

Remarque : cette méthode ne peut être utilisée qu'avec les types de fichiers déclarés dans l'instruction fileTypes du descripteur de l'application.

Paramètres

Voir aussi

Spécifie si cette application est actuellement attribuée par défaut pour ouvrir les fichiers portant l'extension spécifiée.

Paramètres

Voir aussi

Invoque une commande de collage interne sur l'objet d'affichage qui a le focus.

Cet appel de fonction est ignoré si le composant n'implémente pas la commande. Seuls les objets d'affichage descendant des classes TextField ou HTMLLoader peuvent implémenter cette commande actuellement.

Supprime cette application en tant qu'application par défaut pour ouvrir les fichiers portant l'extension spécifiée.

Remarque : cette méthode ne peut être utilisée qu'avec les types de fichiers énumérés dans l'instruction fileTypes du descripteur de l'application.

Paramètres

Voir aussi

Supprime un écouteur de l'objet EventDispatcher. Si aucun écouteur correspondant n'est enregistré auprès de l'objet EventDispatcher, appeler cette méthode n'a aucun effet.

Paramètres

Invoque une commande selectAll interne sur l'objet d'affichage qui a le focus.

Cet appel de fonction est ignoré si le composant n'implémente pas la commande. Seuls les objets d'affichage descendant des classes TextField ou HTMLLoader peuvent implémenter cette commande actuellement.

Définit cette application comme l'application par défaut pour ouvrir les fichiers portant l'extension spécifiée.

Remarque : cette méthode ne peut être utilisée qu'avec les types de fichiers déclarés dans l'instruction fileTypes du descripteur de l'application.

Paramètres

Voir aussi

Distribué lorsque cette application devient l'application active du bureau.

Remarque : cet événement n'a ni « phase de capture », ni « phase de propagation », ce qui signifie que des écouteurs d'événement doivent être ajoutés directement aux cibles potentielles, que la cible soit dans la liste d'affichage ou non.

Les propriétés de cet événement sont les suivantes :

Distribué lorsqu'une application est invoquée par le biais d'un fichier SWF qui s'exécute dans le navigateur de l'utilisateur.

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>

Distribué lorsque le focus du bureau est muté vers une application différente.

Remarque : cet événement n'a ni « phase de capture », ni « phase de propagation », ce qui signifie que des écouteurs d'événement doivent être ajoutés directement aux cibles potentielles, que la cible soit dans la liste d'affichage ou non.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque la séquence de fermeture de l'application commence.

L'événement exiting est distribué lorsque la fermeture de l'application est initiée par le système d'exploitation, par exemple lorsqu'un utilisateur tape la combinaison de touches Cmd-Q sous Mac OS X, ou lorsque la propriété autoExitde l'objet NativeApplication est true et que la dernière fenêtre de l'application est fermée. L'annulation de cet événement empêche la fermeture de l'application.

Remarque : un appel à la méthode NativeApplication.exit() n'entraîne pas le déclenchement d'un événement exiting. Pour avertir les composants de la fermeture imminente, déclenchez l'événement exiting avant d'appeler exit().

Les propriétés de cet événement sont les suivantes :

Distribué lorsqu'une application est invoquée.

La seconde invocation d'une application ne démarre pas une autre occurrence de l'application. A la place, la première occurrence reçoit un événement invoke supplémentaire. L'application est chargée de gérer les prochains événements invoke de façon appropriée.

Remarque : tous les événements invoke sont mis en file d'attente. Lorsqu'un écouteur est enregistré pour cet événement, il reçoit tous les événements de la file d'attente, ainsi que les nouveaux événements. Les événements placés en file d'attente peuvent être délivrés avant ou après les nouveaux événements invoke.

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

Distribué lorsqu'une nouvelle connexion réseau devient disponible ou lorsqu'une connexion réseau existante est perdue.

Un événement networkChange ne signifie pas obligatoirement que l'ordinateur hôte est passé en ligne ou hors ligne ; il peut simplement être en transition entre deux types de connexion. Les applications peuvent utiliser cet événement pour optimiser la surveillance de la disponibilité des ressources distantes. Le déclenchement d'un événement networkChange est souvent le bon moment pour vérifier la disponibilité des ressources distantes.

Remarque : il peut y avoir un court délai entre le changement de réseau et l'arrivée de cet événement.

Les propriétés de cet événement sont les suivantes :

Distribué lorsque l'utilisateur est resté inactif pendant la période spécifiée par la propriété idleThreshold.

La durée pendant laquelle l'utilisateur est resté inactif peut être déterminée avec la propriété timeSinceLastUserInput.

Les propriétés de cet événement sont les suivantes :

Voir aussi

Distribué lorsque le système d'exploitation détecte l'activité de la souris ou du clavier après une période d'inactivité.

La durée à partir de laquelle l'inactivité est avérée peut être configurée avec la propriété idleThreshold. La durée pendant laquelle l'utilisateur est resté inactif peut être déterminée avec la propriété timeSinceLastUserInput.

Les propriétés de cet événement sont les suivantes :

Voir aussi