NativeApplication  - AS3

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.

Cette propriété n’est pas prise en charge sur les plates-formes qui ne prennent pas en charge la classe NativeWindow.

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.

Cette propriété n’est pas prise en charge sur les plates-formes qui ne prennent pas en charge la classe NativeWindow.

Indique si l’application s’exécute en arrière-plan ou non.

Lorsque executeInBackground est définie sur false (valeur par défaut), l’application reste dans l’état interrompu lorsqu’elle passe en arrière-plan. Lorsque executeInBackground est définie sur true, l’application peut s’exécuter en arrière-plan.

Remarque : avec les versions 21 et antérieures de SWF, AIR ne prend pas en charge l’exécution en arrière-plan sur iOS et Android lorsque le mode de rendu est défini sur direct. En raison de cette restriction, les applications basées sur Stage3D ne peuvent pas exécuter des tâches en arrière-plan telles que la lecture de l’audio, les mises à jour d’emplacement, les téléchargements vers/depuis le réseau, etc. iOS n’autorise pas les appels OpenGLES/de rendu en arrière-plan. Il interrompt ainsi les applications qui tentent de lancer des appels en arrière-plan. Android ne restreint pas les appels OpenGLES ou toute autre tâche en arrière-plan lancée par les applications (telle que la lecture d’audio). Avec les versions 22 et ultérieures de SWF, les applications mobiles AIR peuvent s’exécuter en arrière-plan lorsque renderMode est définir sur direct. Le moteur d’exécution AIR iOS entraîne une erreur ActionScript (3768 - L’API Stage3D ne peut pas être utilisée lors d’une exécution en arrière-plan) si les appels OpenGLES sont effectués en arrière-plan. Cependant, aucune erreur ne se produit sur Android car ses applications natives sont autorisées à effectuer des appels OpenGLES en arrière-plan. Pour une utilisation optimale des ressources mobiles, n’effectuez pas d’appels de rendu lorsqu’une application s’exécute en arrière-plan.

Cette propriété est prise en charge sur AIR iOS et Android.

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. Lorsque l’icône d’une application n’est pas prise en charge, NativeApplication.supportsDockIcon et NativeApplication.supportsSystemTrayIcon sont tous deux définis sur false et 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.

Eléments de l’API associés

Nombre de secondes devant s’écouler sans saisie utilisateur avant qu’un événement userIdle ne soit distribué.

Par défaut, le seuil d’inactivité est de 300 secondes (5 minutes). La plage acceptable des valeurs est comprise entre 5 (5 secondes) et 86 400 (1 jour), inclus.

Eléments de l’API associés

Indique si l’application est compilée ou interprétée pour la plate-forme de votre choix. Cette API renvoie (true) uniquement sous iOS pour les cibles (ipa-app-store, IPA-DEBUG, ipa-ad-hoc). Pour les autres plates-formes AIR, cette API renvoie (false).

Menu de l’application.

Les menus d’application sont pris en charge lorsque NativeApplication.supportsMenu est égal à 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. Assigner un objet NativeMenu à cette propriété lorsque NativeApplication.supportsMenu est égal à false est autorisé mais sans effet. Assurez-vous d’utiliser la propriété NativeApplication.supportsMenu pour déterminer si le système d’exploitation prend en charge les menus d’applications. Faire appel à d’autres méthodes (comme Capabilities.os) pour déterminer les prises en charge peut entraîner des erreurs de programmation (si certains systèmes d’exploitation cible possibles ne sont pas pris en compte).

Prise en charge du profil AIR : cette fonctionnalité n’est pas prise en charge sur les périphériques mobiles ou les périphériques AIR pour TV. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.

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.

Eléments de l’API associés

Occurrence singleton de l’objet NativeApplication.

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

Cette propriété n’est pas prise en charge sur les plates-formes qui ne prennent pas en charge la classe NativeWindow.

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.

Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur tous les systèmes d’exploitation de bureau, mais ne l’est pas sur les périphériques mobiles ou les périphériques AIR pour TV. Vous pouvez tester la prise en charge lors de l’exécution à l’aide de la propriété NativeApplication.supportsStartAtLogin. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.

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.

Eléments de l’API associés

Indiques si les méthodes setAsDefaultApplication(), removeAsDefaultApplication() et isSetAsDefaultApplication() sont prises en charge sur la plate-forme actuelle.

Si elle est définie sur true, les méthodes ci-dessus fonctionnent comme indiqué. Si elle est définie sur false, setAsDefaultApplication() et removeDefaultApplication() n’ont aucun effet, etisSetAsDefaultApplication() renvoie false.

Eléments de l’API associés

Indique si AIR prend en charge les icônes d’applications de type Dock dans le système d’exploitation actuel.

Si elle est définie sur true, la propriété NativeApplication.icon est de type DockIcon.

L’interface utilisateur Mac OS X fournit un « Dock » d’applications contenant les icônes des applications en cours d’exécution ou fréquemment utilisées.

Utilisez la propriété NativeApplication.supportsDockIcon pour déterminer si le système d’exploitation prend en charge les icônes d’ancrage de l’application. Faire appel à d’autres méthodes (comme Capabilities.os) pour déterminer les prises en charge peut entraîner des erreurs de programmation (si certains systèmes d’exploitation cible possibles ne sont pas pris en compte).

Eléments de l’API associés

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.

Utilisez la propriété NativeApplication.supportsMenu pour déterminer si le système d’exploitation prend en charge la barre de menus de l’application. Faire appel à d’autres méthodes (comme Capabilities.os) pour déterminer les prises en charge peut entraîner des erreurs de programmation (si certains systèmes d’exploitation cible possibles ne sont pas pris en compte).

Eléments de l’API associés

Indique si la propriété startAtLogin est prise en charge sur la plate-forme actuelle.

Si elle est définie sur true, startAtLogin fonctionne comme indiqué. Si elle définie sur false, startAtLogin n’a aucun effet.

Eléments de l’API associés

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

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

L’interface utilisateur Windows fournit une « barre d’état système » dans la barre des tâches, officiellement appelée Zone de notification, dans laquelle il est possible d’afficher les icônes des applications. Aucune icône par défaut n’est affichée. Vous devez définir le tableau bitmaps de l’objet icon pour afficher une icône.

Utilisez la propriété NativeApplication.supportsSystemTrayIcon pour déterminer si le système d’exploitation prend en charge les icônes de la barre d’état système. Faire appel à d’autres méthodes (comme Capabilities.os) pour déterminer les prises en charge peut entraîner des erreurs de programmation (si certains systèmes d’exploitation cible possibles ne sont pas pris en compte).

Eléments de l’API associés

Permet aux applications d’empêcher l’interface utilisateur de passer en mode « inactif ».

Valeur de la classe SystemIdleMode ayant une incidence sur le comportement du mode Inactif du système hôte. Cette propriété prend effet uniquement dans l’application ayant le focus d’entrée et n’est accessible qu’à partir du contenu s’exécutant dans le sandbox de l’application.

Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur les périphériques mobiles, mais ne l’est pas sur les systèmes d’exploitation de bureau ou sur les périphériques AIR pour TV. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.

Eléments de l’API associés

L’heure, en secondes, depuis la dernière saisie utilisateur.

Eléments de l’API associés

Active cette application.

Cette méthode n’est pas prise en charge sur les plates-formes qui ne prennent pas en charge la classe NativeWindow.

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 les fenêtres des autres applications éventuellement ouvertes (Si le paramètre window est null, toute fenêtre visible de cette application est activée.)

La méthode activate() na pas d’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énement, 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 uniquement pour la phase cible ou la phase de propagation vers le haut. Ces deux phases sont associées pendant l’enregistrement car la propagation vers le haut 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 écouteurs d’événement ne sont pas automatiquement supprimés de la mémoire, car le nettoyeur de mémoire ne supprime pas l’écouteur tant que l’objet de distribution existe (à moins que le paramètre useWeakReference ne soit défini sur true).

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 le nouveau nœud nécessite un écouteur d’événement, 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. Pour toutes les fenêtres ouvertes, les objets NativeWindow distribuent des événements closing et close. L’appel de la méthode preventDefault() de l’objet d’événement closing empêche la fermeture de l’application.

Remarque : cette méthode n’est pas prise en charge sur le système d’exploitation iOS.

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.

Cette méthode n’est pas applicable aux périphériques AIR pour TV. Si vous l’appelez avec un type de fichier déclaré dans le descripteur d’application, elle renvoie null.

Paramètres

Eléments de l’API associés

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

Prise en charge du profil AIR : cette fonctionnalité est prise en charge sur tous les systèmes d’exploitation de bureau, mais ne l’est pas sur les périphériques mobiles ou les périphériques AIR pour TV. Vous pouvez tester la prise en charge lors de l’exécution à l’aide de la propriété NativeApplication.supportsDefaultApplication. Voir Prise en charge du profil AIR pour plus d’informations sur la prise en charge de l’API dans plusieurs profils.

Paramètres

Eléments de l’API associés

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

Eléments de l’API associés

Supprime un écouteur de l’objet EventDispatcher. Si aucun écouteur correspondant n’est enregistré auprès de l’objet EventDispatcher, l’appel de 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

Eléments de l’API associés

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 périphériques AIR pour TV ne distribuent jamais automatiquement cet événement. Il est cependant possible de le distribuer manuellement.

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 périphériques AIR pour TV ne distribuent jamais automatiquement cet événement. Il est cependant possible de le distribuer manuellement.

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é autoExit de 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.

Les périphériques AIR pour TV ne distribuent jamais l’événement exiting.

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, distribuez 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é lorsque l’utilisateur appuie sur une touche. L’occurrence de NativeApplication fournit cet événement pour prendre en charge les raccourcis clavier. Cet événement de clavier est tout d’abord distribué à NativeApplication. L’annulation de cet événement annule également les raccourcis de menu de NativeWindow. Cet événement se produit avant l’événement keyUp.

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

Eléments de l’API associés

Distribué lorsque l’utilisateur relâche une touche. L’occurrence de NativeApplication fournit cet événement pour prendre en charge les raccourcis clavier. Cet événement de clavier est tout d’abord distribué à NativeApplication. L’annulation de cet événement n’a aucun effet sur d’autres objets (tels que les raccourcis de menu de NativeWindow). Cet événement se produit après un événement keyDown.

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

Eléments de l’API associés

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.

Remarques :

• Il peut exister un court délai entre le changement de réseau et l’arrivée de cet événement.
• Sur Android, l’objet NativeApplication risque de distribuer plus d’un événement networkChange pour chaque changement d’une connexion réseau.

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

Distribué lorsque l’application est sur le point d’être interrompue par le système d’exploitation.

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

Distribué lorsque l’utilisateur a été inactif.

Spécifiez la période durant laquelle un utilisateur doit être inactif avant la distribution de cet événement, à l’aide de la propriété idleThreshold. La durée pendant laquelle l’utilisateur est resté inactif peut être déterminée avec la propriété timeSinceLastUserInput.

Remarque : cet événement n’est pas distribué sur les périphériques mobiles ou les périphériques AIR pour TV.

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

Eléments de l’API associés

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

Remarque : cet événement n’est pas distribué sur les périphériques mobiles ou les périphériques AIR pour TV.

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 :

Eléments de l’API associés