| Pakiet | flash.desktop |
| Klasa | public class SystemTrayIcon |
| Dziedziczenie | SystemTrayIcon  InteractiveIcon Icon EventDispatcher Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Obsługa profilów AIR: Ta funkcja jest obsługiwana w systemach operacyjnych dla komputerów stacjonarnych, ale nie jest obsługiwana na urządzeniach przenośnych ani na urządzeniach telewizyjnych ze środowiskiem AIR. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.
Nie wszystkie systemy operacyjne zawierają ikony zasobnika systemowego. Należy sprawdzić właściwość NativeApplication.supportsSystemTrayIcon, aby określić, czy ikony zasobnika systemowego są obsługiwane w tym systemie.
Instancja klasy SystemTrayIcon nie może być utworzona. Pobierz obiekt reprezentujący ikonę zasobnika systemowego z właściwości icon „globalnego” obiektu NativeApplication.
Jeśli obsługiwane są ikony zasobnika systemowego, ikona będzie należała do typu SystemTrayIcon. W innym przypadku typem właściwości icon będzie inna subklasa ikony InteractiveIcon (z reguły subklasa DockIcon).
Ważne: próba wywołania metody klasy SystemTrayIcon w obiekcie NativeApplication.icon w systemie operacyjnym, dla którego aplikacja AIR nie obsługuje ikon zasobnika systemowego, wygeneruje wyjątek uruchamiania.
Powiązane elementy interfejsu API
flash.desktop.NativeApplication.supportsSystemTrayIcon
flash.desktop.DockIcon
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
| bitmaps : Array [przesłanianie]
Obraz ikony jest tablicą różnego rozmiaru obiektów BitmapData. | SystemTrayIcon | ||
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| height : int [przesłanianie] [tylko do odczytu]
Obecna wysokość wyświetlania ikony w pikselach. | SystemTrayIcon | ||
| menu : NativeMenu
Menu ikony zasobnika systemowego. | SystemTrayIcon | ||
| tooltip : String
Podpowiedź wyskakująca dla zasobnika systemowego. | SystemTrayIcon | ||
| width : int [przesłanianie] [tylko do odczytu]
Obecna szerokość wyświetlania ikony w pikselach. | SystemTrayIcon | ||
| Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
|---|---|---|---|---|
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | ||
| Wywoływane przez ten obiekt SystemTrayIcon po kliknięciu lewym przyciskiem myszy. | SystemTrayIcon | |||
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | ||
| Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy w dół. | SystemTrayIcon | |||
| Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy w górę. | SystemTrayIcon | |||
| Wywoływane przez ten obiekt SystemTrayIcon po kliknięciu prawym przyciskiem myszy. | SystemTrayIcon | |||
| Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy przy naciśniętym prawym przycisku. | SystemTrayIcon | |||
| Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy przy zwolnionym prawym przycisku. | SystemTrayIcon | |||
| Stała | Zdefiniowane przez | ||
|---|---|---|---|
| MAX_TIP_LENGTH : Number = 63 [statyczny]
Dozwolona długość podpowiedzi zasobnika systemowego. | SystemTrayIcon | ||
bitmaps | właściwość |
bitmaps:Array[przesłanianie] | Wersje środowiska wykonawczego: | AIR 1.0 |
Obraz ikony jest tablicą różnego rozmiaru obiektów BitmapData.
Kiedy ikona jest wyświetlana w danym kontekście systemu operacyjnego, wówczas używany jest najbliższy pod względem rozmiaru obraz bitmapowy z tablicy (w razie konieczności wyskalowany). Typowe rozmiary to: 16x16, 32x32, 48x48 oraz 128x128. (Ikony 512x512 pikseli mogą być wykorzystane w przyszłości w niektórych systemach operacyjnych).
W niektórych kontekstach system operacyjny może wykorzystać domyślną ikonę systemową, jeżeli nic nie zostało przypisane do właściwości bitmaps. W pozostałych kontekstach nie pojawia się żadna ikona.
Aby ustawić lub zmienić wygląd ikony, należy przypisać tablicę obiektów bitmapData do właściwości bitmaps.
icon.bitmaps = new Array(icon16x16.bitmapData, icon128x128.bitmapData);
Bezpośrednie modyfikowanie tablicy bitmaps nie daje efektów.
Aby usunąć obraz ikony, należy przypisać pustą tablicę do właściwości bitmaps.
Uwaga: Podczas ładowania pliku obrazu ikony format PNG pliku z reguły zapewnia najlepsze mieszanie alpha. Format GIF obsługuje jedynie włączanie i wyłączanie przezroczystości (brak mieszania). Format JPG w ogóle nie obsługuje przezroczystości.
Implementacja
override public function get bitmaps():Array override public function set bitmaps(value:Array):void height | właściwość |
height:int [tylko do odczytu] [przesłanianie] | Wersje środowiska wykonawczego: | AIR 1.0 |
Obecna wysokość wyświetlania ikony w pikselach.
Niektóre konteksty ikon obsługują dynamiczne rozmiary. Właściwość height wskazuje wysokość ikony wybranej z tablicy bitmaps obecnego kontekstu. Faktyczna wysokość wyświetlania może być inna, jeżeli system operacyjny wyskalował ikonę.
Implementacja
override public function get height():int menu | właściwość |
menu:NativeMenu| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Menu ikony zasobnika systemowego.
Implementacja
public function get menu():NativeMenu public function set menu(value:NativeMenu):void tooltip | właściwość |
tooltip:String| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Podpowiedź wyskakująca dla zasobnika systemowego. Jeżeli ciąg znaków jest dłuższy niż parametr SystemTrayIcon.MAX_TIP_LENGTH, wówczas końcówka zostanie przycięta.
Implementacja
public function get tooltip():String public function set tooltip(value:String):void width | właściwość |
width:int [tylko do odczytu] [przesłanianie] | Wersje środowiska wykonawczego: | AIR 1.0 |
Obecna szerokość wyświetlania ikony w pikselach.
Niektóre konteksty ikon obsługują dynamiczne rozmiary. Właściwość width wskazuje szerokość ikony wybranej z tablicy bitmaps obecnego kontekstu. Faktyczna szerokość wyświetlania może być inna jeżeli system operacyjny wyskalował ikonę.
Implementacja
override public function get width():int click | Zdarzenie |
flash.events.ScreenMouseEventwłaściwość ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.CLICK| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane przez ten obiekt SystemTrayIcon po kliknięciu lewym przyciskiem myszy.
StałaScreenMouseEvent.CLICK definiuje wartość właściwości type obiektu zdarzenia click.
To zdarzenie ma następujące właściwości istotne w omawianym kontekście:
| Właściwość | Wartość |
|---|---|
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
screenX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
screenY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
target | Obiekt SystemTrayIcon pod wskaźnikiem urządzenia wskazującego. |
mouseDown | Zdarzenie |
flash.events.ScreenMouseEventwłaściwość ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.MOUSE_DOWN| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy w dół.
StałaScreenMouseEvent.MOUSE_DOWN definiuje wartość właściwości type obiektu zdarzenia mouseDown.
To zdarzenie ma następujące właściwości istotne w omawianym kontekście:
| Właściwość | Wartość |
|---|---|
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
screenX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
screenY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
target | Obiekt SystemTrayIcon pod wskaźnikiem urządzenia wskazującego. |
mouseUp | Zdarzenie |
flash.events.ScreenMouseEventwłaściwość ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.MOUSE_UP| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy w górę.
StałaScreenMouseEvent.MOUSE_UP definiuje wartość właściwości type obiektu zdarzenia mouseUp.
To zdarzenie ma następujące właściwości istotne w omawianym kontekście:
| Właściwość | Wartość |
|---|---|
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
screenX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
screenY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
target | Obiekt SystemTrayIcon pod wskaźnikiem urządzenia wskazującego. |
rightClick | Zdarzenie |
flash.events.ScreenMouseEventwłaściwość ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.RIGHT_CLICK| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane przez ten obiekt SystemTrayIcon po kliknięciu prawym przyciskiem myszy.
StałaScreenMouseEvent.RIGHT_CLICK definiuje wartość właściwości type obiektu zdarzenia rightClick.
To zdarzenie ma następujące właściwości istotne w omawianym kontekście:
| Właściwość | Wartość |
|---|---|
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
screenX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
screenY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
target | Obiekt SystemTrayIcon pod wskaźnikiem urządzenia wskazującego. |
rightMouseDown | Zdarzenie |
flash.events.ScreenMouseEventwłaściwość ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy przy naciśniętym prawym przycisku.
StałaScreenMouseEvent.RIGHT_MOUSE_DOWN definiuje wartość właściwości type obiektu zdarzenia rightMouseDown.
To zdarzenie ma następujące właściwości istotne w omawianym kontekście:
| Właściwość | Wartość |
|---|---|
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
screenX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
screenY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
target | Obiekt SystemTrayIcon pod wskaźnikiem urządzenia wskazującego. |
rightMouseUp | Zdarzenie |
flash.events.ScreenMouseEventwłaściwość ScreenMouseEvent.type =
flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP| Wersje środowiska wykonawczego: | AIR 1.0 |
Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy przy zwolnionym prawym przycisku.
StałaScreenMouseEvent.RIGHT_MOUSE_UP definiuje wartość właściwości type obiektu zdarzenia rightMouseUp.
To zdarzenie ma następujące właściwości istotne w omawianym kontekście:
| Właściwość | Wartość |
|---|---|
buttonDown | true, jeśli główny przycisk myszy jest naciśnięty; false w przeciwnym wypadku. |
ctrlKey | true w systemach Windows lub Linux, jeśli klawisz Ctrl jest aktywny. true w systemach Mac, jeśli aktywny jest klawisz Ctrl albo Command. W przeciwnym razie false. |
currentTarget | Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. |
shiftKey | true, jeśli klawisz Shift jest aktywny; false, jeśli jest nieaktywny. |
commandKey | true w systemach Mac, jeśli klawisz Command jest aktywny; false, jeśli jest nieaktywny. Zawsze false w systemach Windows. |
controlKey | true, jeśli klawisz Ctrl lub Control jest aktywny; false, jeśli jest nieaktywny. |
screenX | Współrzędna pozioma miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
screenY | Współrzędna pionowa miejsca wystąpienia zdarzenia (w układzie współrzędnych ekranu). |
target | Obiekt SystemTrayIcon pod wskaźnikiem urządzenia wskazującego. |
MAX_TIP_LENGTH | Stała |
public static const MAX_TIP_LENGTH:Number = 63| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.0 |
Dozwolona długość podpowiedzi zasobnika systemowego.
Tue Jun 12 2018, 12:06 PM Z