| Paket | flash.desktop |
| Klasse | public class SystemTrayIcon |
| Vererbung | SystemTrayIcon  InteractiveIcon Icon EventDispatcher Object |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
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.supportsSystemTrayIcon
flash.desktop.DockIcon
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 | ||
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| Wird beim Klicken mit der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst. | SystemTrayIcon | |||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| Wird beim Drücken der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst. | SystemTrayIcon | |||
| Wird beim Loslassen der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst. | SystemTrayIcon | |||
| Wird beim Klicken mit der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst. | SystemTrayIcon | |||
| Wird beim Drücken der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst. | SystemTrayIcon | |||
| Wird beim Loslassen der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst. | SystemTrayIcon | |||
| Konstante | Definiert von | ||
|---|---|---|---|
| MAX_TIP_LENGTH : Number = 63 [statisch]
Die zulässige Länge des Quickinfos für das Infobereich-Symbol. | SystemTrayIcon | ||
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 menu | Eigenschaft |
menu:NativeMenu| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das Menü des Infobereich-Symbols.
Implementierung
public function get menu():NativeMenu public function set menu(value:NativeMenu):void 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 click | Ereignis |
flash.events.ScreenMouseEventEigenschaft ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.CLICK| Laufzeitversionen: | AIR 1.0 |
Wird beim Klicken mit der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.
DieScreenMouseEvent.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 |
flash.events.ScreenMouseEventEigenschaft ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.MOUSE_DOWN| Laufzeitversionen: | AIR 1.0 |
Wird beim Drücken der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.
DieScreenMouseEvent.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 |
flash.events.ScreenMouseEventEigenschaft ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.MOUSE_UP| Laufzeitversionen: | AIR 1.0 |
Wird beim Loslassen der Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.
DieScreenMouseEvent.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 |
flash.events.ScreenMouseEventEigenschaft ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.RIGHT_CLICK| Laufzeitversionen: | AIR 1.0 |
Wird beim Klicken mit der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.
DieScreenMouseEvent.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 |
flash.events.ScreenMouseEventEigenschaft 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.
DieScreenMouseEvent.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 |
flash.events.ScreenMouseEventEigenschaft ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP| Laufzeitversionen: | AIR 1.0 |
Wird beim Loslassen der rechten Maustaste von diesem SystemTrayIcon-Objekt ausgelöst.
DieScreenMouseEvent.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. |
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.
Tue Jun 12 2018, 10:04 AM Z