SystemTrayIcon - Adobe ActionScript® 3 (AS3 ) API-Referenz

Paket	flash.desktop
Klasse	public class SystemTrayIcon
Vererbung	SystemTrayIcon InteractiveIcon Icon EventDispatcher Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Die SystemTrayIcon-Klasse repräsentiert das Symbol im Stil des Windows^®-Taskleisten-Infobereichs.

Unterstützung von AIR-Profilen: Diese Funktion wird auf Desktopbetriebssystemen unterstützt, jedoch nicht auf mobilen Geräten oder Geräten mit AIR für TV. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.

Nicht alle Desktop-Betriebssysteme verfügen über Infobereich-Symbole. Überprüfen Sie NativeApplication.supportsSystemTrayIcon, um festzustellen, ob Symbole für den Infobereich auf dem aktuellen System unterstützt werden.

Es kann keine Instanz der SystemTrayIcon-Klasse erstellt werden. Rufen Sie das Objekt, das das Infobereichsymbol darstellt, von der icon-Eigenschaft des „globalen“ NativeApplication-Objekts ab.

Wenn Infobereichsymbole unterstützt werden, hat das Symbol den Typ SystemTrayIcon. Andernfalls weist icon eine andere Unterklasse von InteractiveIcon, normalerweise DockIcon, auf.

Wichtig: Beim Versuch, eine Methode der SystemTrayIcon-Klasse für das NativeApplication.icon-Objekt auf einem Betriebssystem aufzurufen, für das AIR keine Infobereichsymbole unterstützt, tritt ein Laufzeitausnahmefehler auf.

Verwandte API-Elemente

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

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		bitmaps : Array [override] Das Symbolbild als ein Array von BitmapData-Objekten in verschiedenen Größen.	SystemTrayIcon
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		height : int [override] [schreibgeschützt] Die aktuelle Anzeigehöhe des Symbols in Pixel.	SystemTrayIcon
		menu : NativeMenu Das Menü des Infobereich-Symbols.	SystemTrayIcon
		tooltip : String Das Quickinfo, das für das Infobereich-Symbol angezeigt wird.	SystemTrayIcon
		width : int [override] [schreibgeschützt] Die aktuelle Anzeigebreite des Symbols in Pixel.	SystemTrayIcon

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird.	EventDispatcher
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
click	Wird beim Klicken mit der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.	SystemTrayIcon
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
mouseDown	Wird beim Drücken der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.	SystemTrayIcon
mouseUp	Wird beim Loslassen der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.	SystemTrayIcon
rightClick	Wird beim Klicken mit der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.	SystemTrayIcon
rightMouseDown	Wird beim Drücken der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.	SystemTrayIcon
rightMouseUp	Wird beim Loslassen der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.	SystemTrayIcon

Öffentliche Konstanten

	Konstante		Definiert von
		MAX_TIP_LENGTH : Number = 63 [statisch] Die zulässige Länge des Quickinfos für das Infobereich-Symbol.	SystemTrayIcon

Eigenschaftendetails

bitmaps

Eigenschaft

bitmaps:Array[override]

Laufzeitversionen:

AIR 1.0

Das Symbolbild als ein Array von BitmapData-Objekten in verschiedenen Größen.

Wenn ein Symbol in einem bestimmten Betriebssystemkontext angezeigt wird, wird die Bitmap aus dem Array verwendet, die der angezeigten Größe am nächsten kommt. Falls erforderlich, wird die Bitmap skaliert. Gebräuchliche Größen sind 16x16, 32x32, 48x48 und 128x128. (Mit einigen Betriebssystemen können in naher Zukunft Symbole in der Größe 512x512 Pixel verwendet werden.)

In bestimmten Kontexten verwendet das Betriebssystem möglicherweise ein Standardsymbol, wenn der bitmaps-Eigenschaft keine Eingabe zugewiesen wurde. In anderen Kontexten wird kein Symbol angezeigt.

Um das Erscheinungsbild des Symbols festzulegen oder zu ändern, weisen Sie der bitmaps-Eigenschaft ein Array mit bitmapData-Objekten zu:

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

Das direkte Ändern des bitmaps-Array hat keine Auswirkungen.

Um das Symbolbild zu löschen, weisen Sie der bitmaps-Eigenschaft ein leeres Array zu.

Hinweis: Beim Laden von Bilddateien für ein Symbol erzielen Sie die beste Alphamischung im Allgemeinen mit dem PNG-Dateiformat. Das GIF-Format unterstützt nur Transparenz oder keine Transparenz (keine Mischmodi). Das JPG-Format unterstützt keine Transparenz.

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

height

Eigenschaft

height:int [schreibgeschützt] [override]

Laufzeitversionen:

AIR 1.0

Die aktuelle Anzeigehöhe des Symbols in Pixel.

Einige Symbolkontexte unterstützen dynamische Größen. Die height-Eigenschaft gibt die Höhe des Symbols an, das für den aktuellen Kontext aus dem bitmaps-Array ausgewählt wurde. Die tatsächliche Anzeigehöhe kann davon abweichen, falls das Betriebssystem das Symbol skaliert hat.

Implementierung
override public function get height():int

tooltip

Eigenschaft

tooltip:String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Das Quickinfo, das für das Infobereich-Symbol angezeigt wird. Wenn der String länger ist als SystemTrayIcon.MAX_TIP_LENGTH, wird das Quickinfo abgeschnitten.

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

width

Eigenschaft

width:int [schreibgeschützt] [override]

Laufzeitversionen:

AIR 1.0

Die aktuelle Anzeigebreite des Symbols in Pixel.

Einige Symbolkontexte unterstützen dynamische Größen. Die width-Eigenschaft gibt die Breite des Symbols an, das für den aktuellen Kontext aus dem bitmaps-Array ausgewählt wurde. Die tatsächliche Anzeigebreite kann davon abweichen, falls das Betriebssystem das Symbol skaliert hat.

Implementierung
override public function get width():int

Ereignisdetails

click

Ereignis

Ereignisobjekttyp: flash.events.ScreenMouseEvent
Eigenschaft ScreenMouseEvent.type = flash.events.ScreenMouseEvent.CLICK

Laufzeitversionen:

AIR 1.0

Wird beim Klicken mit der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.

Die ScreenMouseEvent.CLICK-Konstante definiert den Wert der type-Eigenschaft eines click-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

Eigenschaft	Wert
`buttonDown`	`true`, wenn die primäre Maustaste gedrückt wird; andernfalls `false`.
`ctrlKey`	`true` unter Windows oder Linux, wenn die Strg-Taste aktiv ist. `true` unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird `false` zurückgegeben.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`shiftKey`	`true`, wenn die Umschalttaste aktiv ist; `false`, wenn sie nicht aktiv ist.
`commandKey`	`true` unter Mac OS, falls die Befehlstaste aktiviert ist; `false`, wenn sie deaktiviert ist. Unter Windows immer `false`
`controlKey`	`true`, wenn die Strg- oder Ctrl-Taste aktiv ist; `false`, wenn sie nicht aktiv ist.
`screenX`	Die horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`screenY`	Die vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`target`	Das SystemTrayIcon-Objekt unter dem Zeigegerät.

mouseDown

Ereignis

Ereignisobjekttyp: flash.events.ScreenMouseEvent
Eigenschaft ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_DOWN

Laufzeitversionen:

AIR 1.0

Wird beim Drücken der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.

Die ScreenMouseEvent.MOUSE_DOWN-Konstante definiert den Wert der type-Eigenschaft eines mouseDown -Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

Eigenschaft	Wert
`buttonDown`	`true`, wenn die primäre Maustaste gedrückt wird; andernfalls `false`.
`ctrlKey`	`true` unter Windows oder Linux, wenn die Strg-Taste aktiv ist. `true` unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird `false` zurückgegeben.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`shiftKey`	`true`, wenn die Umschalttaste aktiv ist; `false`, wenn sie nicht aktiv ist.
`commandKey`	`true` unter Mac OS, falls die Befehlstaste aktiviert ist; `false`, wenn sie deaktiviert ist. Unter Windows immer `false`
`controlKey`	`true`, wenn die Strg- oder Ctrl-Taste aktiv ist; `false`, wenn sie nicht aktiv ist.
`screenX`	Die horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`screenY`	Die vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`target`	Das SystemTrayIcon-Objekt unter dem Zeigegerät.

mouseUp

Ereignis

Ereignisobjekttyp: flash.events.ScreenMouseEvent
Eigenschaft ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_UP

Laufzeitversionen:

AIR 1.0

Wird beim Loslassen der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.

Die ScreenMouseEvent.MOUSE_UP-Konstante definiert den Wert der type-Eigenschaft eines mouseUp-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

Eigenschaft	Wert
`buttonDown`	`true`, wenn die primäre Maustaste gedrückt wird; andernfalls `false`.
`ctrlKey`	`true` unter Windows oder Linux, wenn die Strg-Taste aktiv ist. `true` unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird `false` zurückgegeben.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`shiftKey`	`true`, wenn die Umschalttaste aktiv ist; `false`, wenn sie nicht aktiv ist.
`commandKey`	`true` unter Mac OS, falls die Befehlstaste aktiviert ist; `false`, wenn sie deaktiviert ist. Unter Windows immer `false`
`controlKey`	`true`, wenn die Strg- oder Ctrl-Taste aktiv ist; `false`, wenn sie nicht aktiv ist.
`screenX`	Die horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`screenY`	Die vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`target`	Das SystemTrayIcon-Objekt unter dem Zeigegerät.

rightClick

Ereignis

Ereignisobjekttyp: flash.events.ScreenMouseEvent
Eigenschaft ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_CLICK

Laufzeitversionen:

AIR 1.0

Wird beim Klicken mit der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.

Die ScreenMouseEvent.RIGHT_CLICK-Konstante definiert den Wert der type-Eigenschaft eines rightClick-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

Eigenschaft	Wert
`buttonDown`	`true`, wenn die primäre Maustaste gedrückt wird; andernfalls `false`.
`ctrlKey`	`true` unter Windows oder Linux, wenn die Strg-Taste aktiv ist. `true` unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird `false` zurückgegeben.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`shiftKey`	`true`, wenn die Umschalttaste aktiv ist; `false`, wenn sie nicht aktiv ist.
`commandKey`	`true` unter Mac OS, falls die Befehlstaste aktiviert ist; `false`, wenn sie deaktiviert ist. Unter Windows immer `false`
`controlKey`	`true`, wenn die Strg- oder Ctrl-Taste aktiv ist; `false`, wenn sie nicht aktiv ist.
`screenX`	Die horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`screenY`	Die vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`target`	Das SystemTrayIcon-Objekt unter dem Zeigegerät.

rightMouseDown

Ereignis

Ereignisobjekttyp: flash.events.ScreenMouseEvent
Eigenschaft ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN

Laufzeitversionen:

AIR 1.0

Wird beim Drücken der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.

Die ScreenMouseEvent.RIGHT_MOUSE_DOWN-Konstante definiert den Wert der type-Eigenschaft eines rightMouseDown-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

Eigenschaft	Wert
`buttonDown`	`true`, wenn die primäre Maustaste gedrückt wird; andernfalls `false`.
`ctrlKey`	`true` unter Windows oder Linux, wenn die Strg-Taste aktiv ist. `true` unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird `false` zurückgegeben.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`shiftKey`	`true`, wenn die Umschalttaste aktiv ist; `false`, wenn sie nicht aktiv ist.
`commandKey`	`true` unter Mac OS, falls die Befehlstaste aktiviert ist; `false`, wenn sie deaktiviert ist. Unter Windows immer `false`
`controlKey`	`true`, wenn die Strg- oder Ctrl-Taste aktiv ist; `false`, wenn sie nicht aktiv ist.
`screenX`	Die horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`screenY`	Die vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`target`	Das SystemTrayIcon-Objekt unter dem Zeigegerät.

rightMouseUp

Ereignis

Ereignisobjekttyp: flash.events.ScreenMouseEvent
Eigenschaft ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP

Laufzeitversionen:

AIR 1.0

Wird beim Loslassen der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.

Die ScreenMouseEvent.RIGHT_MOUSE_UP-Konstante definiert den Wert der type-Eigenschaft eines rightMouseUp-Ereignisobjekts.

Dieses Ereignis verfügt über die folgenden relevanten Eigenschaften:

Eigenschaft	Wert
`buttonDown`	`true`, wenn die primäre Maustaste gedrückt wird; andernfalls `false`.
`ctrlKey`	`true` unter Windows oder Linux, wenn die Strg-Taste aktiv ist. `true` unter Mac OS, falls die Strg-Taste oder die Befehlstaste aktiv ist. Andernfalls wird `false` zurückgegeben.
`currentTarget`	Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
`shiftKey`	`true`, wenn die Umschalttaste aktiv ist; `false`, wenn sie nicht aktiv ist.
`commandKey`	`true` unter Mac OS, falls die Befehlstaste aktiviert ist; `false`, wenn sie deaktiviert ist. Unter Windows immer `false`
`controlKey`	`true`, wenn die Strg- oder Ctrl-Taste aktiv ist; `false`, wenn sie nicht aktiv ist.
`screenX`	Die horizontale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`screenY`	Die vertikale Koordinate, bei der das Ereignis aufgetreten ist, in Bildschirmkoordinaten.
`target`	Das SystemTrayIcon-Objekt unter dem Zeigegerät.

Konstantendetails

MAX_TIP_LENGTH

Konstante

public static const MAX_TIP_LENGTH:Number = 63

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Die zulässige Länge des Quickinfos für das Infobereich-Symbol.

Rechtliche Hinweise | Onlinedatenschutzerklärung

SystemTrayIcon - AS3

Klassen x

bitmaps

height

menu

tooltip

width

click

mouseDown

mouseUp

rightClick

rightMouseDown

rightMouseUp

MAX_TIP_LENGTH