flash.desktop.SystemTrayIcon (ActionScript 3.0)

	Propriété	Défini par
		bitmaps : Array [override] Image de l'icône sous forme de tableau d'objets BitmapData de tailles différentes.	SystemTrayIcon
		constructor : Object Référence à l'objet de classe ou à la fonction constructeur d'une occurrence donnée d'un objet.	Object
		height : int [override] [lecture seule] Hauteur d'affichage actuelle de l'icône, en pixels.	SystemTrayIcon
		menu : NativeMenu Menu de l'icône de barre d'état système.	SystemTrayIcon
		prototype : Object [statique] Référence à l'objet prototype d'un objet de classe ou fonction.	Object
		tooltip : String Info-bulle qui s'affiche pour l'icône de barre d'état système.	SystemTrayIcon
		width : int [override] [lecture seule] Largeur d'affichage actuelle de l'icône, en pixels.	SystemTrayIcon

	Méthode	Défini par
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	EventDispatcher
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d'événements.	EventDispatcher
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l'objet EventDispatcher pour un type spécifique d'événement.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indique si la propriété spécifiée d'un objet est définie.	Object
		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
		propertyIsEnumerable(name:String):Boolean Indique si la propriété spécifiée existe et est énumérable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l'objet EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Définit la disponibilité d'une propriété dynamique pour les opérations en boucle.	Object
		toString():String Renvoie la représentation sous forme de chaîne de l'objet spécifié.	Object
		valueOf():Object Renvoie la valeur primitive de l'objet spécifié.	Object
		willTrigger(type:String):Boolean Vérifie si un écouteur d'événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d'événement spécifié.	EventDispatcher

Synthèse	Défini par
activate	[Evénement de diffusion] Distribué lorsque l'application Flash Player obtient le focus du système d'exploitation et devient active.	EventDispatcher
click	Distribué par cet objet SystemTrayIcon lorsque l'utilisateur clique avec sa souris.	SystemTrayIcon
deactivate	[Evénement de diffusion] Distribué lorsque l'application Flash Player ou AIR perd le focus du système d'exploitation et devient inactive.	EventDispatcher
mouseDown	Distribué par cet objet SystemTrayIcon lorsque l'utilisateur enfonce le bouton de sa souris.	SystemTrayIcon
mouseUp	Distribué par cet objet SystemTrayIcon lorsque l'utilisateur relâche le bouton de sa souris.	SystemTrayIcon
rightClick	Distribué par cet objet SystemTrayIcon lorsque l'utilisateur clique du bouton droit de sa souris.	SystemTrayIcon
rightMouseDown	Distribué par cet objet SystemTrayIcon lorsque l'utilisateur enfonce le bouton droit de sa souris.	SystemTrayIcon
rightMouseUp	Distribué par cet objet SystemTrayIcon lorsque l'utilisateur relâche le bouton droit de sa souris.	SystemTrayIcon

	Constante	Défini par
		MAX_TIP_LENGTH : Number = 63 [statique] Longueur autorisée de l'info-bulle de l'icône de la barre d'état système.	SystemTrayIcon

bitmaps:Array [lecture-écriture] [override]

Versions du moteur d'exécution:

AIR 1.0

Image de l'icône sous forme de tableau d'objets BitmapData de tailles différentes.

Lorsqu'une icône est affichée dans le contexte d'un certain système d'exploitation, l'image bitmap du tableau se rapprochant le plus de la taille affichée est utilisée (et éventuellement mise à l'échelle). Les tailles courantes sont 16x16, 32x32, 48x48 et 128x128. (Des icônes de 512x512 pixels peuvent être utilisées pour des système d'exploitation futurs.)

Dans certains cas, le système d'exploitation peut utiliser une icône système par défaut lorsque rien n'a été affecté à la propriété bitmaps. Dans d'autres cas, aucune icône n'apparaît.

Pour définir ou modifier l'apparence de l'icône, affectez un tableau d'objets bitmapData à la propriété bitmaps :

icon.bitmaps = new Array(icon16x16.bitmapData, icon128x128.bitmapData);

La modification directe du tableau bitmaps n'a aucun effet.

Pour effacer l'image de l'icône, affectez un tableau vide à la propriété bitmaps.

Remarque : lors du chargement de fichiers image pour une icône, le format de fichier PNG fournit généralement le meilleur fondu alpha. Le format GIF ne prend en charge que l'activation ou la désactivation de la transparence (pas le fondu). Le format JPG ne prend pas en charge la transparence du tout.

Implémentation
public function get bitmaps():Array
public function set bitmaps(value:Array):void

height:int [lecture seule] [override]

Versions du moteur d'exécution:

AIR 1.0

Hauteur d'affichage actuelle de l'icône, en pixels.

Certains contextes d'icône prennent en charge les tailles dynamiques. La propriété height indique la hauteur de l'icône choisie dans le tableau bitmaps pour le contexte actuel. La hauteur d'affichage réelle peut être différente si le système d'exploitation a mis l'icône à l'échelle.

Implémentation
public function get height():int

menu:NativeMenu [lecture-écriture]

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0

Menu de l'icône de barre d'état système.

Implémentation
public function get menu():NativeMenu
public function set menu(value:NativeMenu):void

tooltip:String [lecture-écriture]

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0

Info-bulle qui s'affiche pour l'icône de barre d'état système. Si la longueur est supérieure à SystemTrayIcon.MAX_TIP_LENGTH, l'info-bulle est tronquée.

Implémentation
public function get tooltip():String
public function set tooltip(value:String):void

width:int [lecture seule] [override]

Versions du moteur d'exécution:

AIR 1.0

Largeur d'affichage actuelle de l'icône, en pixels.

Certains contextes d'icône prennent en charge les tailles dynamiques. La propriété width indique la largeur de l'icône choisie dans le tableau bitmaps pour le contexte actuel. La largeur d'affichage réelle peut être différente si le système d'exploitation a mis l'icône à l'échelle.

Implémentation
public function get width():int

Type d'objet événement: flash.events.ScreenMouseEvent
propriété ScreenMouseEvent.type = flash.events.ScreenMouseEvent.CLICK

Versions du moteur d'exécution:

AIR 1.0

Distribué par cet objet SystemTrayIcon lorsque l'utilisateur clique avec sa souris.

La constante ScreenMouseEvent.CLICK définit la valeur de la propriété type d'un objet événement click.

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

Propriété	Valeur
`buttonDown`	`true` si le bouton principal de la souris est enfoncé ; `false` dans tous les autres cas.
`ctrlKey`	`true` sous Windows ou Linux si la touche Ctrl est enfoncée. `true` sur Mac si la touche Ctrl ou la touche Commande est activée. Autrement, `false`.
`currentTarget`	L'objet qui traite activement l'objet Event avec un écouteur d'événements.
`shiftKey`	`true` si la touche Maj est activée ; `false` si elle ne l'est pas.
`commandKey`	`true` sur le Mac si la touche Commande est activée ; `false` si elle est désactivée. Toujours `false` sur Windows.
`controlKey`	`true` si la touche Ctrl ou Contrôle est activée ; `false` si elle est désactivée.
`screenX`	Coordonnée horizontale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`screenY`	Coordonnée verticale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`target`	L'objet SystemTrayIcon sous le périphérique de pointage.

Type d'objet événement: flash.events.ScreenMouseEvent
propriété ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_DOWN

Versions du moteur d'exécution:

AIR 1.0

Distribué par cet objet SystemTrayIcon lorsque l'utilisateur enfonce le bouton de sa souris.

La constante ScreenMouseEvent.MOUSE_DOWN définit la valeur de la propriété type d'un objet événement mouseDown.

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

Propriété	Valeur
`buttonDown`	`true` si le bouton principal de la souris est enfoncé ; `false` dans tous les autres cas.
`ctrlKey`	`true` sous Windows ou Linux si la touche Ctrl est enfoncée. `true` sur Mac si la touche Ctrl ou la touche Commande est activée. Autrement, `false`.
`currentTarget`	L'objet qui traite activement l'objet Event avec un écouteur d'événements.
`shiftKey`	`true` si la touche Maj est activée ; `false` si elle ne l'est pas.
`commandKey`	`true` sur le Mac si la touche Commande est activée ; `false` si elle est désactivée. Toujours `false` sur Windows.
`controlKey`	`true` si la touche Ctrl ou Contrôle est activée ; `false` si elle est désactivée.
`screenX`	Coordonnée horizontale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`screenY`	Coordonnée verticale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`target`	L'objet SystemTrayIcon sous le périphérique de pointage.

Type d'objet événement: flash.events.ScreenMouseEvent
propriété ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_UP

Versions du moteur d'exécution:

AIR 1.0

Distribué par cet objet SystemTrayIcon lorsque l'utilisateur relâche le bouton de sa souris.

La constante ScreenMouseEvent.MOUSE_UP définit la valeur de la propriété type d'un objet événement mouseUp.

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

Propriété	Valeur
`buttonDown`	`true` si le bouton principal de la souris est enfoncé ; `false` dans tous les autres cas.
`ctrlKey`	`true` sous Windows ou Linux si la touche Ctrl est enfoncée. `true` sur Mac si la touche Ctrl ou la touche Commande est activée. Autrement, `false`.
`currentTarget`	L'objet qui traite activement l'objet Event avec un écouteur d'événements.
`shiftKey`	`true` si la touche Maj est activée ; `false` si elle ne l'est pas.
`commandKey`	`true` sur le Mac si la touche Commande est activée ; `false` si elle est désactivée. Toujours `false` sur Windows.
`controlKey`	`true` si la touche Ctrl ou Contrôle est activée ; `false` si elle est désactivée.
`screenX`	Coordonnée horizontale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`screenY`	Coordonnée verticale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`target`	L'objet SystemTrayIcon sous le périphérique de pointage.

Type d'objet événement: flash.events.ScreenMouseEvent
propriété ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_CLICK

Versions du moteur d'exécution:

AIR 1.0

Distribué par cet objet SystemTrayIcon lorsque l'utilisateur clique du bouton droit de sa souris.

La constante ScreenMouseEvent.RIGHT_CLICK définit la valeur de la propriété type d'un objet événement rightClick.

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

Propriété	Valeur
`buttonDown`	`true` si le bouton principal de la souris est enfoncé ; `false` dans tous les autres cas.
`ctrlKey`	`true` sous Windows ou Linux si la touche Ctrl est enfoncée. `true` sur Mac si la touche Ctrl ou la touche Commande est activée. Autrement, `false`.
`currentTarget`	L'objet qui traite activement l'objet Event avec un écouteur d'événements.
`shiftKey`	`true` si la touche Maj est activée ; `false` si elle ne l'est pas.
`commandKey`	`true` sur le Mac si la touche Commande est activée ; `false` si elle est désactivée. Toujours `false` sur Windows.
`controlKey`	`true` si la touche Ctrl ou Contrôle est activée ; `false` si elle est désactivée.
`screenX`	Coordonnée horizontale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`screenY`	Coordonnée verticale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`target`	L'objet SystemTrayIcon sous le périphérique de pointage.

Type d'objet événement: flash.events.ScreenMouseEvent
propriété ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN

Versions du moteur d'exécution:

AIR 1.0

Distribué par cet objet SystemTrayIcon lorsque l'utilisateur enfonce le bouton droit de sa souris.

La constante ScreenMouseEvent.RIGHT_MOUSE_DOWN définit la valeur de la propriété type d'un objet événement rightMouseDown.

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

Propriété	Valeur
`buttonDown`	`true` si le bouton principal de la souris est enfoncé ; `false` dans tous les autres cas.
`ctrlKey`	`true` sous Windows ou Linux si la touche Ctrl est enfoncée. `true` sur Mac si la touche Ctrl ou la touche Commande est activée. Autrement, `false`.
`currentTarget`	L'objet qui traite activement l'objet Event avec un écouteur d'événements.
`shiftKey`	`true` si la touche Maj est activée ; `false` si elle ne l'est pas.
`commandKey`	`true` sur le Mac si la touche Commande est activée ; `false` si elle est désactivée. Toujours `false` sur Windows.
`controlKey`	`true` si la touche Ctrl ou Contrôle est activée ; `false` si elle est désactivée.
`screenX`	Coordonnée horizontale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`screenY`	Coordonnée verticale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`target`	L'objet SystemTrayIcon sous le périphérique de pointage.

Type d'objet événement: flash.events.ScreenMouseEvent
propriété ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP

Versions du moteur d'exécution:

AIR 1.0

Distribué par cet objet SystemTrayIcon lorsque l'utilisateur relâche le bouton droit de sa souris.

La constante ScreenMouseEvent.RIGHT_MOUSE_UP définit la valeur de la propriété type d'un objet événement rightMouseUp.

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

Propriété	Valeur
`buttonDown`	`true` si le bouton principal de la souris est enfoncé ; `false` dans tous les autres cas.
`ctrlKey`	`true` sous Windows ou Linux si la touche Ctrl est enfoncée. `true` sur Mac si la touche Ctrl ou la touche Commande est activée. Autrement, `false`.
`currentTarget`	L'objet qui traite activement l'objet Event avec un écouteur d'événements.
`shiftKey`	`true` si la touche Maj est activée ; `false` si elle ne l'est pas.
`commandKey`	`true` sur le Mac si la touche Commande est activée ; `false` si elle est désactivée. Toujours `false` sur Windows.
`controlKey`	`true` si la touche Ctrl ou Contrôle est activée ; `false` si elle est désactivée.
`screenX`	Coordonnée horizontale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`screenY`	Coordonnée verticale à laquelle l'événement s'est produit, par rapport aux coordonnées de l'écran.
`target`	L'objet SystemTrayIcon sous le périphérique de pointage.

public static const MAX_TIP_LENGTH:Number = 63

Version du langage:

ActionScript 3.0

Versions du moteur d'exécution:

AIR 1.0

Longueur autorisée de l'info-bulle de l'icône de la barre d'état système.

Guide de référence du langage et des composants ActionScript 3.0		Accueil \| Tous les packages \| Toutes les classes \| Eléments du langage \| Index \| Annexes \| Conventions \| Afficher les encadrés Masquer les encadrés
SystemTrayIcon	Propriétés \| Méthodes \| Evénements \| Constantes

Package	flash.desktop
Classe	public class SystemTrayIcon
Héritage	SystemTrayIcon InteractiveIcon Icon EventDispatcher Object