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():int
bounce | () | 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