| Paket | flash.desktop |
| Sınıf | public class DockIcon |
| Miras Alma | DockIcon InteractiveIcon Icon EventDispatcher Object |
| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
AIR profili desteği: Bu özellik tüm masaüstü işletim sistemlerinde desteklenir ancak mobil aygıtlarda veya AIR for TV aygıtlarında desteklenmez. Desteği çalışma zamanında NativeApplication.supportsDockIcon özelliğini kullanarak test edebilirsiniz. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
DockIcon sınıfını standart simgenin görünümünü değiştirmek; örneğin simgeye animasyon uygulamak veya bilgilendirici grafik eklemek için kullanabilirsiniz. Ayrıca öğeleri simge seti menüsüne ekleyebilirsiniz. Eklediğiniz menü öğeleri, standart menü öğelerinin üzerinde görüntülenir.
DockIcon sınıfının bir örneği oluşturulamaz. İşletim sistemi simge setini temsil eden nesneyi NativeApplication.icon öğesinden alın.
Tüm işletim sistemlerinde simge seti bulunmaz. Simge setlerinin geçerli sistemde desteklenip desteklenmediğini belirlemek için NativeApplication.supportsDockIcon öğesini kontrol edin. Simge setleri destekleniyorsa, NativeApplication.icon özelliği DockIcon türünde olur. Aksi halde NativeApplication.icon türü, genellikle SystemTrayIcon olmak üzere InteractiveIcon öğesinin başka bir alt sınıfı olur.
Önemli: AIR'nin simge setlerini desteklemediği işletim sistemindeki NativeApplication.icon nesnesi üzerinde SystemTrayIcon sınıfı yöntemini çağırmayı denediğinizde çalışma zamanı istisnası oluşturur.
İlgili API Öğeleri
flash.desktop.NativeApplication.supportsDockIcon
flash.desktop.SystemTrayIcon
| Özellik | Tanımlayan: | ||
|---|---|---|---|
| bitmaps : Array [geçersiz kıl]
Farklı boyutlardaki BitmapData nesnelerinin bir dizisi olarak simge görüntüsü. | DockIcon | ||
![]() | constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | |
| height : int [geçersiz kıl] [salt okunur]
Simgenin piksel cinsinden geçerli görüntüleme yüksekliği. | DockIcon | ||
| menu : NativeMenu
Bu simge setinin sistem tarafından sağlanan menüsü. | DockIcon | ||
| width : int [geçersiz kıl] [salt okunur]
Simgenin piksel cinsinden geçerli görüntüleme genişliği. | DockIcon | ||
| Yöntem | Tanımlayan: | ||
|---|---|---|---|
![]() | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | EventDispatcher | |
Ortaya çıkan dikkat gerektirebilecek bir olayı kullanıcıya bildirir. | DockIcon | ||
![]() |
Olay akışına bir olay gönderir. | EventDispatcher | |
![]() |
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | |
![]() |
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | |
![]() |
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | |
![]() |
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | |
![]() |
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | |
![]() |
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | |
![]() |
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | |
![]() |
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | |
![]() |
Belirtilen nesnenin temel değerini döndürür. | Object | |
![]() |
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | EventDispatcher | |
bitmaps | özellik |
bitmaps:Array[geçersiz kıl] | Çalışma Zamanı Sürümleri: | AIR 1.0 |
Farklı boyutlardaki BitmapData nesnelerinin bir dizisi olarak simge görüntüsü.
Bir simge, belirli bir işletim sistemi bağlamında görüntülendiğinde, görüntülenen boyuta en yakın olan dizideki bitmap kullanılır (ve gerekirse ölçeklenir). Ortak boyutlara 16x16, 32x32, 48x48 ve 128x128 dahildir. (512x512 piksel simgeler, yakın gelecekte bazı işletim sistemleri simgeleri için kullanılabilir.)
Bazı bağlamlarda işletim sistemi, bitmaps özelliğine hiçbir öğe atanmadığında, varsayılan bir sistem simgesi kullanabilir. Diğer bağlamlarda herhangi bir simge görünmez.
Simge görünümünü ayarlamak veya değiştirmek için bitmaps özelliğine, BitmapData nesnelerini içeren bir dizi atayın:
icon.bitmaps = new Array(icon16x16.bitmapData, icon128x128.bitmapData);
bitmaps dizisini doğrudan değiştirmenin bir etkisi yoktur.
Simge görüntüsünü temizlemek için bitmaps özelliğine boş bir dizi atayın.
Not: Bir simgeye yönelik görüntü dosyalarını yüklerken, PNG dosya biçimi genellikle en iyi alfa karışımını sunar. GIF biçimi yalnızca açık veya kapalı saydamlığı (karışım olmadan) destekler. JPG biçimi saydamlığı desteklemez.
Uygulama
override public function get bitmaps():Array override public function set bitmaps(value:Array):void height | özellik |
height:int [salt okunur] [geçersiz kıl] | Çalışma Zamanı Sürümleri: | AIR 1.0 |
Simgenin piksel cinsinden geçerli görüntüleme yüksekliği.
Bazı simge bağlamları, dinamik boyutları destekler. height özelliği, geçerli bağlamın bitmaps dizisinden seçilen simgenin yüksekliğini gösterir. Gerçek görüntüleme yüksekliği, işletim sisteminin simgeyi ölçeklemiş olması durumunda farklı olabilir.
Uygulama
override public function get height():int menu | özellik |
menu:NativeMenu| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Bu simge setinin sistem tarafından sağlanan menüsü.
Menüdeki tüm öğeler, standart öğelerin üzerinde görüntülenir. Standart öğeler değiştirilemez veya kaldırılamaz.
Uygulama
public function get menu():NativeMenu public function set menu(value:NativeMenu):voidÖrnek ( Bu örnek nasıl kullanılır? )
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 | özellik |
width:int [salt okunur] [geçersiz kıl] | Çalışma Zamanı Sürümleri: | AIR 1.0 |
Simgenin piksel cinsinden geçerli görüntüleme genişliği.
Bazı simge bağlamları, dinamik boyutları destekler. width özelliği, geçerli bağlamın bitmaps dizisinden seçilen simgenin genişliğini gösterir. Gerçek görüntüleme genişliği, işletim sisteminin simgeyi ölçeklemiş olması durumunda farklı olabilir.
Uygulama
override public function get width():intbounce | () | yöntem |
public function bounce(priority:String = "informational"):void| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | AIR 1.0 |
Ortaya çıkan dikkat gerektirebilecek bir olayı kullanıcıya bildirir.
Bu yöntemin çağrılması, yalnızca uygulamanın arka planda olması durumunda simge setini sektirir. priority öğesi NotificationType.Informational ise simge bir kez seker. priority öğesi NotificationType.Critical ise, simge, uygulama ön plana getirilene kadar seker.
Parametreler
priority:String (default = "informational") — Simge setinin sekme aciliyeti.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
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, 01:09 PM Z
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster