Pakiet | flash.desktop |
Klasa | public class DockIcon |
Dziedziczenie | DockIcon 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 we wszystkich komputerowych systemach operacyjnych, ale nie jest obsługiwana na urządzeniach przenośnych ani na urządzeniach telewizyjnych ze środowiskiem AIR. W czasie wykonywania można sprawdzić, czy ta funkcja jest obsługiwana, odczytując właściwość NativeApplication.supportsDockIcon
. 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.
Można użyć klasę DockIcon aby zmienić wygląd ikony standardowej, na przykład w celu animacji ikony lub dodania grafik informacyjnych. Można również dodać elementy do menu ikon doku. Dodawane pozycje menu są wyświetlane powyżej standardowych pozycji menu.
Instancja klasy DockIcon nie może być utworzona. Pobierz obiekt reprezentujący ikonę Docku sytemu operacyjnego z właściwości NativeApplication.icon
.
Nie wszystkie systemy operacyjne posiadają ikony doku. Należy sprawdzić właściwość NativeApplication.supportsDockIcon
, aby określić, czy ikony doku są obsługiwane w tym systemie. Jeżeli ikony doku są obsługiwane, wówczas właściwość NativeApplication.icon
będzie typu DockIcon. W innym przypadku typem właściwości NativeApplication.icon
będzie inna subklasa ikony InteractiveIcon (z reguły subklasa SystemTrayIcon).
Ważne: Próba wywołania metody klasy DockIcon w obiekcie NativeApplication.icon
w systemie operacyjnym, dla którego aplikacja AIR nie obsługuje ikon doku, wygeneruje wyjątek uruchamiania.
Powiązane elementy interfejsu API
flash.desktop.NativeApplication.supportsDockIcon
flash.desktop.SystemTrayIcon
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
bitmaps : Array [przesłanianie]
Obraz ikony jest tablicą różnego rozmiaru obiektów BitmapData. | DockIcon | ||
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. | DockIcon | ||
menu : NativeMenu
Menu zdefiniowane przez system dla tej ikony doku. | DockIcon | ||
width : int [przesłanianie] [tylko do odczytu]
Obecna szerokość wyświetlania ikony w pikselach. | DockIcon |
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 | ||
Powiadamia użytkownika o wystąpieniu zdarzenia, które może wymagać uwagi. | DockIcon | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher |
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 zdefiniowane przez system dla tej ikony doku.
Każdy element menu będzie wyświetlony nad elementami standardowymi. Elementy standardowe nie mogą być modyfikowane ani usuwane.
Implementacja
public function get menu():NativeMenu
public function set menu(value:NativeMenu):void
Przykład ( Sposób korzystania z tego przykładu )
import flash.desktop.NativeApplication; import flash.events.Event; private function createDockIconMenu():void{ if(NativeApplication.supportsDockIcon){ var dockIcon:DockIcon = NativeApplication.nativeApplication.icon as DockIcon; var dockMenu:NativeMenu = new NativeMenu(); var command:NativeMenuItem = dockMenu.addItem(new NativeMenuItem("Command")); command.addEventListener(Event.SELECT, onCommand); dockIcon.menu = dockMenu; } } private function onCommand(event:Event):void{ //do command... }
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
bounce | () | metoda |
public function bounce(priority:String = "informational"):void
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0 |
Powiadamia użytkownika o wystąpieniu zdarzenia, które może wymagać uwagi.
Wywołanie tej metody "odbije" ikonę doku tylko wtedy, gdy aplikacja znajduje się w tle. Jeżeli właściwość priority
ma wartość NotificationType.Informational
, wówczas odbicie będzie pojedyncze. Jeżeli właściwość priority
ma wartość NotificationType.Critical
, wówczas ikona będzie odbijana do momentu, kiedy aplikacja zostanie przeniesiona na pierwszy plan.
Parametry
priority:String (default = "informational ") — Stopień pilności, przy którym należy odbić dok.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
import flash.display.DockIcon; import flash.display.NotificationType; import flash.desktop.NativeApplication; if(NativeApplication.supportsDockIcon){ var dockIcon:DockIcon = NativeApplication.nativeApplication.icon As DockIcon; dockIcon.bounce(NotificationType.CRITICAL); }
package { import flash.desktop.DockIcon; import flash.desktop.NativeApplication; import flash.display.Loader; import flash.display.NativeMenu; import flash.display.NativeMenuItem; import flash.display.Sprite; import flash.events.Event; import flash.events.TimerEvent; import flash.net.URLRequest; import flash.utils.Timer; public class AnimatedDockIcon extends Sprite { private var imageURLs:Array = ['gfx/frame01.png', 'gfx/frame02.png', 'gfx/frame03.png', 'gfx/frame04.png']; private var images:Array = new Array(); private var animTimer:Timer = new Timer(100); public function AnimatedDockIcon() { NativeApplication.nativeApplication.autoExit = false; addEventListener(Event.COMPLETE, loadImages); loadImages(); animTimer.addEventListener(TimerEvent.TIMER,advanceFrame); addMenu(); stage.nativeWindow.close(); } private function addMenu():void{ var menu:NativeMenu = new NativeMenu(); var start:NativeMenuItem = menu.addItem(new NativeMenuItem("Start animation")); var stop:NativeMenuItem = menu.addItem(new NativeMenuItem("Stop animation")); start.addEventListener(Event.SELECT, startTimer); stop.addEventListener(Event.SELECT, stopTimer); var dockIcon:DockIcon = NativeApplication.nativeApplication.icon as DockIcon; dockIcon.menu = menu; } private function startTimer(event:Event):void{ animTimer.start(); } private function stopTimer(event:Event):void{ animTimer.stop(); } private var currentFrame:int = 0; private function advanceFrame(event:Event):void{ if(currentFrame < images.length){ currentFrame++; } else { currentFrame = 0; } NativeApplication.nativeApplication.icon.bitmaps = [images[currentFrame]]; } private function loadImages(event:Event = null):void{ if(event != null){ images.push(event.target.content.bitmapData); } if(imageURLs.length > 0){ var urlString:String = imageURLs.pop(); var loader:Loader = new Loader(); loader.contentLoaderInfo.addEventListener(Event.COMPLETE, loadImages, false, 0, true); loader.load(new URLRequest(urlString)); } else { var complete:Event = new Event(Event.COMPLETE,false,false); dispatchEvent(complete); } } } }
Tue Jun 12 2018, 12:06 PM Z