| Pacchetto | flash.desktop |
| Classe | public class DockIcon |
| Ereditarietà | DockIcon  InteractiveIcon Icon EventDispatcher Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Supporto profili AIR: questa funzionalità è supportata in tutti i sistemi operativi desktop ma non nei dispositivi mobili o nei dispositivi AIR per TV. È possibile verificare se la funzionalità è supportata in fase runtime utilizzando la proprietà NativeApplication.supportsDockIcon. Per ulteriori informazioni sul supporto delle API tra più profili, vedete Supporto dei profili AIR.
Potete utilizzare la classe DockIcon per modificare l'aspetto dell'icona standard, ad esempio, per animare l'icona o per aggiungere immagini informative. Potete inoltre aggiungere voci al menu dell'icona del dock. Le voci di menu che aggiungete vengono visualizzate sopra le voci di menu standard.
Non è possibile creare un'istanza della classe DockIcon. Potete ottenere l'oggetto che rappresenta l'icona del dock del sistema operativo da NativeApplication.icon.
Non tutti i sistemi operativi presentano delle icone del dock. Per determinare se il sistema operativo utilizzato supporta icone del dock, usate NativeApplication.supportsDockIcon. Se le icone del dock sono supportate, la proprietà NativeApplication.icon è di tipo DockIcon. In caso contrario, il tipo di NativeApplication.icon è un'altra sottoclasse di InteractiveIcon, in genere SystemTrayIcon.
Importante: se tentate di chiamare un metodo della classe DockIcon sull'oggetto NativeApplication.icon in un sistema operativo per il quale AIR non supporta le icone del dock, verrà generata un'eccezione di runtime.
Elementi API correlati
flash.desktop.NativeApplication.supportsDockIcon
flash.desktop.SystemTrayIcon
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
| bitmaps : Array [override]
L'immagine dell'icona come array di oggetti BitmapData di diverse dimensioni. | DockIcon | ||
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| height : int [override] [sola lettura]
L'altezza di visualizzazione corrente dell'icona in pixel. | DockIcon | ||
| menu : NativeMenu
Il menu fornito dal sistema di questa icona del dock. | DockIcon | ||
| width : int [override] [sola lettura]
La larghezza di visualizzazione corrente dell'icona in pixel. | DockIcon | ||
| Metodo | Definito da | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un oggetto listener di eventi con un oggetto EventDispatcher, in modo che il listener riceva la notifica di un evento. | EventDispatcher | |
Avvisa l'utente che si è verificato un evento che può richiedere la sua attenzione. | DockIcon | ||
|
Invia un evento nel flusso di eventi. | EventDispatcher | |
|
Verifica se per l'oggetto EventDispatcher sono presenti listener registrati per un tipo specifico di evento. | EventDispatcher | |
|
Indica se per un oggetto è definita una proprietà specifica. | Object | |
|
Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro. | Object | |
|
Indica se la proprietà specificata esiste ed è enumerabile. | Object | |
|
Rimuove un listener dall'oggetto EventDispatcher. | EventDispatcher | |
|
Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche. | Object | |
|
Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate. | Object | |
|
Restituisce la rappresentazione in formato stringa dell'oggetto specificato. | Object | |
|
Restituisce il valore di base dell'oggetto specificato. | Object | |
|
Verifica se un listener di eventi è registrato con questo oggetto EventDispatcher o qualsiasi suo antenato per il tipo di evento specificato. | EventDispatcher | |
bitmaps | proprietà |
bitmaps:Array[override] | Versioni runtime: | AIR 1.0 |
L'immagine dell'icona come array di oggetti BitmapData di diverse dimensioni.
Quando un'icona viene visualizzata nel contesto di un determinato sistema operativo, viene utilizzata la bitmap nell'array dalle dimensioni più simili alle dimensioni di visualizzazione (ridimensionata, se necessario). Le dimensioni più comuni sono: 16 x 16, 32 x 32, 48 x 48 e 128 x 128. A breve per alcuni sistemi operativi potrebbero essere utilizzate icone da 512 x 512 pixel.
In alcuni contesti, il sistema operativo può utilizzare un'icona di sistema predefinita, se non è stato assegnato nulla alla proprietà bitmaps. In altri contesti, non viene visualizzata alcuna icona.
Per impostare o modificare l'aspetto dell'icona, assegnate alla proprietà bitmaps un array di oggetti bitmapData:
icon.bitmaps = new Array(icon16x16.bitmapData, icon128x128.bitmapData);
Una modifica diretta dell'array bitmaps non avrebbe alcun effetto.
Per annullare l'immagine dell'icona, assegnate un array vuoto alla proprietà bitmaps.
Nota: quando caricate file di immagini per un'icona, tenete presente che il formato file PNG garantisce in genere la migliore fusione alfa. Il formato GIF supporta soltanto l'attivazione o disattivazione della trasparenza (nessuna fusione). mentre il formato JPG non supporta neanche la trasparenza.
Implementazione
override public function get bitmaps():Array override public function set bitmaps(value:Array):void height | proprietà |
height:int [sola lettura] [override] | Versioni runtime: | AIR 1.0 |
L'altezza di visualizzazione corrente dell'icona in pixel.
Alcuni contesti di icone supportano dimensioni dinamiche. La proprietà height indica l'altezza dell'icona scelta dall'array bitmaps per il contesto corrente. L'altezza di visualizzazione effettiva potrebbe essere differente se il sistema operativo ha ridimensionato l'icona.
Implementazione
override public function get height():int menu | proprietà |
menu:NativeMenu| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Il menu fornito dal sistema di questa icona del dock.
Tutte le voci nel menu vengono visualizzate sopra le voci standard. Le voci di menu standard non possono essere modificate o rimosse.
Implementazione
public function get menu():NativeMenu public function set menu(value:NativeMenu):voidEsempio ( Come utilizzare questo esempio )
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 | proprietà |
width:int [sola lettura] [override] | Versioni runtime: | AIR 1.0 |
La larghezza di visualizzazione corrente dell'icona in pixel.
Alcuni contesti di icone supportano dimensioni dinamiche. La proprietà width indica la larghezza dell'icona scelta dall'array bitmaps per il contesto corrente. La larghezza di visualizzazione effettiva potrebbe essere differente se il sistema operativo ha ridimensionato l'icona.
Implementazione
override public function get width():intbounce | () | metodo |
public function bounce(priority:String = "informational"):void| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 1.0 |
Avvisa l'utente che si è verificato un evento che può richiedere la sua attenzione.
Se chiamate questo metodo, l'icona del dock viene fatta "rimbalzare", ma solo se l'applicazione è in background. Se il valore di priority è NotificationType.Informational, l'icona rimbalza una volta. Se invece il valore di priority è NotificationType.Critical, l'icona continua a rimbalzare fino a quando l'applicazione non verrà portata in primo piano.
Parametri
priority:String (default = "informational") |
Elementi API correlati
Esempio ( Come utilizzare questo esempio )
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, 02:44 PM Z