| Pakket | flash.desktop |
| Klasse | public class DockIcon |
| Overerving | DockIcon  InteractiveIcon Icon EventDispatcher Object |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0 |
AIR-profielondersteuning: deze functie wordt ondersteund op alle desktopbesturingssystemen, maar niet op mobiele apparaten en ook niet op AIR for TV-apparaten. Met de eigenschap NativeApplication.supportsDockIcon kunt u testen of deze functie tijdens runtime wordt ondersteund. Zie AIR-profielondersteuning voor meer informatie over API-ondersteuning voor meerdere profielen.
U kunt de klasse DockIcon gebruiken om de weergave van het standaardpictogram te wijzigen, bijvoorbeeld door een animatie of informatieve afbeeldingen aan het pictogram toe te voegen. U kunt ook items aan het menu met Dock-pictogrammen toevoegen. De menu-items die u toevoegt, worden boven de standaardmenu-items weergegeven.
Een instantie van de klasse DockIcon kan niet worden gecreëerd. Hiermee wordt het object dat het Dock-pictogram voor het besturingssysteem vertegenwoordigt in NativeApplication.icon opgehaald.
Niet alle besturingssystemen hebben Dock-pictogrammen. Controleer NativeApplication.supportsDockIcon om te bepalen of Dock-pictogrammen op het huidige systeem worden ondersteund. Als Dock-pictogrammen worden ondersteund, is de eigenschap NativeApplication.icon van het type DockIcon. In andere gevallen is het type van NativeApplication.icon een andere subklasse van InteractiveIcon, doorgaans SystemTrayIcon.
Belangrijk: Wanneer wordt geprobeerd om een methode van de klasse DockIcon aan te roepen voor het NativeApplication.icon-object op een besturingssysteem waarvoor AIR geen Dock-pictogrammen ondersteunt, wordt een runtime-uitzondering gegenereerd.
Verwante API-elementen
flash.desktop.NativeApplication.supportsDockIcon
flash.desktop.SystemTrayIcon
Overerfde openbare eigenschappen verbergen
Overerfde openbare eigenschappen weergeven| Eigenschap | Gedefinieerd door | ||
|---|---|---|---|
| bitmaps : Array [overschrijven]
De pictogramafbeelding als een array van objecten BitmapData van verschillende grootten. | DockIcon | ||
 | constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | |
| height : int [overschrijven] [alleen-lezen]
De huidige weergegeven hoogte van het pictogram in pixels. | DockIcon | ||
| menu : NativeMenu
Het systeemmenu van dit Dock-pictogram. | DockIcon | ||
| width : int [overschrijven] [alleen-lezen]
De weergegeven breedte van het pictogram in pixels. | DockIcon | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | |
Meldt aan de gebruiker dat er een gebeurtenis heeft plaatsgevonden die mogelijk aandacht vereist. | DockIcon | ||
|
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | |
|
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | |
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | |
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
|
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | |
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
|
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher | |
bitmaps | eigenschap |
bitmaps:Array[overschrijven] | Runtimeversies: | AIR 1.0 |
De pictogramafbeelding als een array van objecten BitmapData van verschillende grootten.
Wanneer een pictogram in een bepaalde besturingssysteemcontext wordt weergegeven, wordt de bitmap gebruikt in de array die het weergegeven weergaveformaat het meest benadert (en indien nodig geschaald). Veelgebruikte formaten zijn 16x16, 32x32, 48x48, en 128x128. (In de nabije toekomst kunnen voor sommige besturingssysteempictogrammen pictogrammen van 512x512 pixels worden gebruikt.)
In sommige contexten kan het besturingssysteem een standaard besturingssysteempictogram gebruiken als er niets aan de eigenschap bitmaps is toegewezen. In andere contexten wordt geen pictogram weergegeven.
Als u de weergave van het pictogram wilt instellen of wijzigen, wijst u een array van BitmapData-objecten toe aan de eigenschap bitmaps:
icon.bitmaps = new Array(icon16x16.bitmapData, icon128x128.bitmapData);
Het rechtstreeks wijzigen van de array bitmaps heeft geen effect.
Als u de afbeelding van het pictogram wilt wissen, wijst u een lege array toe aan de eigenschap bitmaps.
Opmerking: De bestandsindeling PNG zorgt doorgaans voor de beste alfa-overvloeiing. De indeling GIF ondersteunt alleen transparantie aan of uit (geen overvloeiing). De indeling JPG ondersteunt helemaal geen transparantie.
Implementatie
override public function get bitmaps():Array override public function set bitmaps(value:Array):void height | eigenschap |
height:int [alleen-lezen] [overschrijven] | Runtimeversies: | AIR 1.0 |
De huidige weergegeven hoogte van het pictogram in pixels.
Sommige pictogramcontexten ondersteunen dynamische grootten. De eigenschap height geeft de hoogte aan van het pictogram dat is gekozen uit de array bitmaps voor de huidige context. De eigenlijke weergavehoogte kan verschillen als het besturingssysteem het pictogram heeft geschaald.
Implementatie
override public function get height():int menu | eigenschap |
menu:NativeMenu| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0 |
Het systeemmenu van dit Dock-pictogram.
Alle items in het menu worden boven de standaarditems weergegeven. De standaarditems kunnen niet worden gewijzigd of verwijderd.
Implementatie
public function get menu():NativeMenu public function set menu(value:NativeMenu):voidVoorbeeld ( Hoe dit voorbeeld te gebruiken )
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 | eigenschap |
width:int [alleen-lezen] [overschrijven] | Runtimeversies: | AIR 1.0 |
De weergegeven breedte van het pictogram in pixels.
Sommige pictogramcontexten ondersteunen dynamische grootten. De eigenschap width geeft de breedte aan van het pictogram dat is gekozen uit de array bitmaps voor de huidige context. De eigenlijke wergavebreedte kan verschillen als het besturingssysteem het pictogram heeft geschaald.
Implementatie
override public function get width():intbounce | () | methode |
public function bounce(priority:String = "informational"):void| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0 |
Meldt aan de gebruiker dat er een gebeurtenis heeft plaatsgevonden die mogelijk aandacht vereist.
Door deze methode aan te roepen 'stuitert' het Dock-pictogram enkel en alleen als de toepassing zich op de achtergrond bevindt. Als de prioriteit NotificationType.Informational is, stuitert het pictogram eenmaal. Als de priority NotificationType.Critical is, stuitert het pictogram totdat de toepassing naar de voorgrond wordt gebracht.
Parameters
priority:String (default = "informational") |
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
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);
}
}
}
}
Wed Jun 13 2018, 11:42 AM Z