SystemTrayIcon - Adobe ActionScript® 3 (AS3 )

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

Klasa SystemTrayIcon reprezentuje ikonę obszaru powiadomień (zasobnika systemowego) paska zadań w systemie Windows^®.

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.icon
flash.desktop.NativeApplication.supportsSystemTrayIcon
flash.desktop.DockIcon

Właściwości publiczne

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

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.	EventDispatcher
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	EventDispatcher

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Podsumowanie	Zdefiniowane przez
activate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.	EventDispatcher
click	Wywoływane przez ten obiekt SystemTrayIcon po kliknięciu lewym przyciskiem myszy.	SystemTrayIcon
deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher
mouseDown	Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy w dół.	SystemTrayIcon
mouseUp	Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy w górę.	SystemTrayIcon
rightClick	Wywoływane przez ten obiekt SystemTrayIcon po kliknięciu prawym przyciskiem myszy.	SystemTrayIcon
rightMouseDown	Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy przy naciśniętym prawym przycisku.	SystemTrayIcon
rightMouseUp	Wywoływane przez ten obiekt SystemTrayIcon po przesunięciu myszy przy zwolnionym prawym przycisku.	SystemTrayIcon

Stałe publiczne

	Stała		Zdefiniowane przez
		MAX_TIP_LENGTH : Number = 63 [statyczny] Dozwolona długość podpowiedzi zasobnika systemowego.	SystemTrayIcon

Szczegół właściwości

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

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

Szczegół zdarzenia

click

Zdarzenie

Typ obiektu zdarzenia: flash.events.ScreenMouseEvent
wł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ła ScreenMouseEvent.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

Typ obiektu zdarzenia: flash.events.ScreenMouseEvent
wł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ła ScreenMouseEvent.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

Typ obiektu zdarzenia: flash.events.ScreenMouseEvent
wł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ła ScreenMouseEvent.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

Typ obiektu zdarzenia: flash.events.ScreenMouseEvent
wł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ła ScreenMouseEvent.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

Typ obiektu zdarzenia: flash.events.ScreenMouseEvent
wł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ła ScreenMouseEvent.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

Typ obiektu zdarzenia: flash.events.ScreenMouseEvent
wł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ła ScreenMouseEvent.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.

Szczegół stałej

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.

Informacje prawne | Zasady prywatności online

SystemTrayIcon - AS3

Pakietyx

Elementy językowe

Dodatki

Pakiet flash.desktop

bitmaps

height

menu

tooltip

width

click

mouseDown

mouseUp

rightClick

rightMouseDown

rightMouseUp

MAX_TIP_LENGTH