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
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.ScreenMouseEvent
Eigenschaft 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.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.
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.ScreenMouseEvent
Eigenschaft 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.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.
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.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.
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.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.
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