SystemTrayIcon - Guida di riferimento alle API Adobe ActionScript® 3 (AS3 )

Pacchetto	flash.desktop
Classe	public class SystemTrayIcon
Ereditarietà	SystemTrayIcon InteractiveIcon Icon EventDispatcher Object

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

La classe SystemTrayIcon rappresenta l’icona in stile area di notifica (barra delle applicazioni) di Windows^®.

Supporto profili AIR: questa funzionalità è supportata nei sistemi operativi desktop ma non nei dispositivi mobili o nei dispositivi AIR per TV. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.

Non tutti i sistemi operativi desktop presentano delle icone della barra delle applicazioni. Per determinare se il sistema operativo utilizzato supporta icone della barra delle applicazioni, usate NativeApplication.supportsSystemTrayIcon.

Non è possibile creare un'istanza della classe SystemTrayIcon. Potete ottenere l'oggetto che rappresenta l'icona della barra delle applicazioni del sistema operativo dalla proprietà icon dell'oggetto "globale" NativeApplication.

Se le icone della barra delle applicazioni sono supportate, l'icona è di tipo SystemTrayIcon. In caso contrario, il tipo di icon sarà un'altra sottoclasse di InteractiveIcon, in genere DockIcon.

Importante: se tentate di chiamare un metodo della classe SystemTrayIcon sull'oggetto NativeApplication.icon in un sistema operativo per il quale AIR non supporta le icone della barra delle applicazioni, verrà generata un'eccezione di runtime.

Elementi API correlati

flash.desktop.NativeApplication.icon
flash.desktop.NativeApplication.supportsSystemTrayIcon
flash.desktop.DockIcon

Proprietà pubbliche

Nascondi proprietà pubbliche ereditate

Mostra proprietà pubbliche ereditate

	Proprietà		Definito da
		bitmaps : Array [override] L'immagine dell'icona come array di oggetti BitmapData di diverse dimensioni.	SystemTrayIcon
		constructor : Object Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto.	Object
		height : int [override] [sola lettura] L'altezza di visualizzazione corrente dell'icona in pixel.	SystemTrayIcon
		menu : NativeMenu Il menu dell'icona della barra delle applicazioni.	SystemTrayIcon
		tooltip : String La descrizione che viene visualizzata per l'icona della barra delle applicazioni.	SystemTrayIcon
		width : int [override] [sola lettura] La larghezza di visualizzazione corrente dell'icona in pixel.	SystemTrayIcon

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento.	EventDispatcher
		dispatchEvent(event:Event):Boolean Invia un evento nel flusso di eventi.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Rimuove un listener dall'oggetto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object
		willTrigger(type:String):Boolean Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato.	EventDispatcher

Eventi

Fate clic per visualizzare altre informazioni sugli eventi

Nascondi eventi ereditati

Mostra eventi ereditati

	Riepilogo	Definito da
activate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR ottiene lo stato di attivazione del sistema operativo ed entra nello stato attivo.	EventDispatcher
click	Inviato dall'oggetto SystemTrayIcon quando si fa clic con il mouse.	SystemTrayIcon
deactivate	[evento di trasmissione] Inviato quando Flash Player o l'applicazione AIR perde l'attivazione del sistema operativo e sta entrando nello stato inattivo.	EventDispatcher
mouseDown	Inviato dall'oggetto SystemTrayIcon quando si preme il pulsante del mouse.	SystemTrayIcon
mouseUp	Inviato dall'oggetto SystemTrayIcon quando si rilascia il pulsante del mouse.	SystemTrayIcon
rightClick	Inviato dall'oggetto SystemTrayIcon quando si fa clic con il pulsante destro del mouse.	SystemTrayIcon
rightMouseDown	Inviato dall'oggetto SystemTrayIcon quando si preme il pulsante destro del mouse.	SystemTrayIcon
rightMouseUp	Inviato dall'oggetto SystemTrayIcon quando si rilascia il pulsante destro del mouse.	SystemTrayIcon

Costanti pubbliche

	Costante		Definito da
		MAX_TIP_LENGTH : Number = 63 [statico] La lunghezza consentita per la descrizione dell'icona della barra delle applicazioni.	SystemTrayIcon

Descrizione delle proprietà

bitmaps

proprietà

bitmaps:Array[override]

Versioni runtime:

AIR 1.0

L'immagine dell'icona come array di oggetti BitmapData di diverse dimensioni.

Quando un'icona viene visualizzata nel contesto di un determinato sistema operativo, viene utilizzata la bitmap nell'array dalle dimensioni più simili alle dimensioni di visualizzazione (ridimensionata, se necessario). Le dimensioni più comuni sono: 16 x 16, 32 x 32, 48 x 48 e 128 x 128. A breve per alcuni sistemi operativi potrebbero essere utilizzate icone da 512 x 512 pixel.

In alcuni contesti, il sistema operativo può utilizzare un'icona di sistema predefinita, se non è stato assegnato nulla alla proprietà bitmaps. In altri contesti, non viene visualizzata alcuna icona.

Per impostare o modificare l'aspetto dell'icona, assegnate alla proprietà bitmaps un array di oggetti bitmapData:

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

Una modifica diretta dell'array bitmaps non avrebbe alcun effetto.

Per annullare l'immagine dell'icona, assegnate un array vuoto alla proprietà bitmaps.

Nota: quando caricate file di immagini per un'icona, tenete presente che il formato file PNG garantisce in genere la migliore fusione alfa. Il formato GIF supporta soltanto l'attivazione o disattivazione della trasparenza (nessuna fusione). mentre il formato JPG non supporta neanche la trasparenza.

Implementazione
override public function get bitmaps():Array
override public function set bitmaps(value:Array):void

height

proprietà

height:int [sola lettura] [override]

Versioni runtime:

AIR 1.0

L'altezza di visualizzazione corrente dell'icona in pixel.

Alcuni contesti di icone supportano dimensioni dinamiche. La proprietà height indica l'altezza dell'icona scelta dall'array bitmaps per il contesto corrente. L'altezza di visualizzazione effettiva potrebbe essere differente se il sistema operativo ha ridimensionato l'icona.

Implementazione
override public function get height():int

tooltip

proprietà

tooltip:String

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

La descrizione che viene visualizzata per l'icona della barra delle applicazioni. Se la stringa è più lunga di SystemTrayIcon.MAX_TIP_LENGTH, la descrizione verrà troncata.

Implementazione
public function get tooltip():String
public function set tooltip(value:String):void

width

proprietà

width:int [sola lettura] [override]

Versioni runtime:

AIR 1.0

La larghezza di visualizzazione corrente dell'icona in pixel.

Alcuni contesti di icone supportano dimensioni dinamiche. La proprietà width indica la larghezza dell'icona scelta dall'array bitmaps per il contesto corrente. La larghezza di visualizzazione effettiva potrebbe essere differente se il sistema operativo ha ridimensionato l'icona.

Implementazione
override public function get width():int

Descrizione degli eventi

click

Evento

Tipo di oggetto evento: flash.events.ScreenMouseEvent
proprietà ScreenMouseEvent.type = flash.events.ScreenMouseEvent.CLICK

Versioni runtime:

AIR 1.0

Inviato dall'oggetto SystemTrayIcon quando si fa clic con il mouse.

La costante ScreenMouseEvent.CLICK definisce il valore della proprietà type di un oggetto evento click.

Questo evento ha le seguenti proprietà pertinenti:

Proprietà	Valore
`buttonDown`	`true` se viene premuto il pulsante principale del mouse; `false` in caso contrario.
`ctrlKey`	`true` in Windows o Linux se il tasto Ctrl è attivo. `true` in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti `false`.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`shiftKey`	`true` se il tasto Maiusc è attivo; `false` se è inattivo.
`commandKey`	`true` in Mac se il tasto Comando è attivo; `false` se è inattivo. Sempre `false` in Windows.
`controlKey`	`true` se il tasto Ctrl è attivo; `false` se è inattivo.
`screenX`	La coordinata orizzontale in cui si è verificato l'evento nelle coordinate dello schermo.
`screenY`	La coordinata verticale in cui si è verificato l'evento nelle coordinate dello schermo.
`target`	L'oggetto SystemTrayIcon che si trova sotto il dispositivo di puntamento.

mouseDown

Evento

Tipo di oggetto evento: flash.events.ScreenMouseEvent
proprietà ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_DOWN

Versioni runtime:

AIR 1.0

Inviato dall'oggetto SystemTrayIcon quando si preme il pulsante del mouse.

La costante ScreenMouseEvent.MOUSE_DOWN definisce il valore della proprietà type di un oggetto evento mouseDown.

Questo evento ha le seguenti proprietà pertinenti:

Proprietà	Valore
`buttonDown`	`true` se viene premuto il pulsante principale del mouse; `false` in caso contrario.
`ctrlKey`	`true` in Windows o Linux se il tasto Ctrl è attivo. `true` in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti `false`.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`shiftKey`	`true` se il tasto Maiusc è attivo; `false` se è inattivo.
`commandKey`	`true` in Mac se il tasto Comando è attivo; `false` se è inattivo. Sempre `false` in Windows.
`controlKey`	`true` se il tasto Ctrl è attivo; `false` se è inattivo.
`screenX`	La coordinata orizzontale in cui si è verificato l'evento nelle coordinate dello schermo.
`screenY`	La coordinata verticale in cui si è verificato l'evento nelle coordinate dello schermo.
`target`	L'oggetto SystemTrayIcon che si trova sotto il dispositivo di puntamento.

mouseUp

Evento

Tipo di oggetto evento: flash.events.ScreenMouseEvent
proprietà ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_UP

Versioni runtime:

AIR 1.0

Inviato dall'oggetto SystemTrayIcon quando si rilascia il pulsante del mouse.

La costante ScreenMouseEvent.MOUSE_UP definisce il valore della proprietà type di un oggetto evento mouseUp.

Questo evento ha le seguenti proprietà pertinenti:

Proprietà	Valore
`buttonDown`	`true` se viene premuto il pulsante principale del mouse; `false` in caso contrario.
`ctrlKey`	`true` in Windows o Linux se il tasto Ctrl è attivo. `true` in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti `false`.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`shiftKey`	`true` se il tasto Maiusc è attivo; `false` se è inattivo.
`commandKey`	`true` in Mac se il tasto Comando è attivo; `false` se è inattivo. Sempre `false` in Windows.
`controlKey`	`true` se il tasto Ctrl è attivo; `false` se è inattivo.
`screenX`	La coordinata orizzontale in cui si è verificato l'evento nelle coordinate dello schermo.
`screenY`	La coordinata verticale in cui si è verificato l'evento nelle coordinate dello schermo.
`target`	L'oggetto SystemTrayIcon che si trova sotto il dispositivo di puntamento.

rightClick

Evento

Tipo di oggetto evento: flash.events.ScreenMouseEvent
proprietà ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_CLICK

Versioni runtime:

AIR 1.0

Inviato dall'oggetto SystemTrayIcon quando si fa clic con il pulsante destro del mouse.

La costante ScreenMouseEvent.RIGHT_CLICK definisce il valore della proprietà type di un oggetto evento rightClick.

Questo evento ha le seguenti proprietà pertinenti:

Proprietà	Valore
`buttonDown`	`true` se viene premuto il pulsante principale del mouse; `false` in caso contrario.
`ctrlKey`	`true` in Windows o Linux se il tasto Ctrl è attivo. `true` in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti `false`.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`shiftKey`	`true` se il tasto Maiusc è attivo; `false` se è inattivo.
`commandKey`	`true` in Mac se il tasto Comando è attivo; `false` se è inattivo. Sempre `false` in Windows.
`controlKey`	`true` se il tasto Ctrl è attivo; `false` se è inattivo.
`screenX`	La coordinata orizzontale in cui si è verificato l'evento nelle coordinate dello schermo.
`screenY`	La coordinata verticale in cui si è verificato l'evento nelle coordinate dello schermo.
`target`	L'oggetto SystemTrayIcon che si trova sotto il dispositivo di puntamento.

rightMouseDown

Evento

Tipo di oggetto evento: flash.events.ScreenMouseEvent
proprietà ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN

Versioni runtime:

AIR 1.0

Inviato dall'oggetto SystemTrayIcon quando si preme il pulsante destro del mouse.

La costante ScreenMouseEvent.RIGHT_MOUSE_DOWN definisce il valore della proprietà type di un oggetto evento rightMouseDown.

Questo evento ha le seguenti proprietà pertinenti:

Proprietà	Valore
`buttonDown`	`true` se viene premuto il pulsante principale del mouse; `false` in caso contrario.
`ctrlKey`	`true` in Windows o Linux se il tasto Ctrl è attivo. `true` in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti `false`.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`shiftKey`	`true` se il tasto Maiusc è attivo; `false` se è inattivo.
`commandKey`	`true` in Mac se il tasto Comando è attivo; `false` se è inattivo. Sempre `false` in Windows.
`controlKey`	`true` se il tasto Ctrl è attivo; `false` se è inattivo.
`screenX`	La coordinata orizzontale in cui si è verificato l'evento nelle coordinate dello schermo.
`screenY`	La coordinata verticale in cui si è verificato l'evento nelle coordinate dello schermo.
`target`	L'oggetto SystemTrayIcon che si trova sotto il dispositivo di puntamento.

rightMouseUp

Evento

Tipo di oggetto evento: flash.events.ScreenMouseEvent
proprietà ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP

Versioni runtime:

AIR 1.0

Inviato dall'oggetto SystemTrayIcon quando si rilascia il pulsante destro del mouse.

La costante ScreenMouseEvent.RIGHT_MOUSE_UP definisce il valore della proprietà type di un oggetto evento rightMouseUp.

Questo evento ha le seguenti proprietà pertinenti:

Proprietà	Valore
`buttonDown`	`true` se viene premuto il pulsante principale del mouse; `false` in caso contrario.
`ctrlKey`	`true` in Windows o Linux se il tasto Ctrl è attivo. `true` in Mac se il tasto Ctrl o il tasto Comando è attivo. Altrimenti `false`.
`currentTarget`	L'oggetto che elabora attivamente l'oggetto Event con un listener di eventi.
`shiftKey`	`true` se il tasto Maiusc è attivo; `false` se è inattivo.
`commandKey`	`true` in Mac se il tasto Comando è attivo; `false` se è inattivo. Sempre `false` in Windows.
`controlKey`	`true` se il tasto Ctrl è attivo; `false` se è inattivo.
`screenX`	La coordinata orizzontale in cui si è verificato l'evento nelle coordinate dello schermo.
`screenY`	La coordinata verticale in cui si è verificato l'evento nelle coordinate dello schermo.
`target`	L'oggetto SystemTrayIcon che si trova sotto il dispositivo di puntamento.

Descrizione delle costanti

MAX_TIP_LENGTH

Costante

public static const MAX_TIP_LENGTH:Number = 63

Versione linguaggio:

ActionScript 3.0

Versioni runtime:

AIR 1.0

La lunghezza consentita per la descrizione dell'icona della barra delle applicazioni.

Note legali | Informativa sulla privacy online

SystemTrayIcon - AS3

Classi x

bitmaps

height

menu

tooltip

width

click

mouseDown

mouseUp

rightClick

rightMouseDown

rightMouseUp

MAX_TIP_LENGTH