SystemTrayIcon - Adobe ActionScript® 3 (AS3 ) API Başvurusu

Paket	flash.desktop
Sınıf	public class SystemTrayIcon
Miras Alma	SystemTrayIcon InteractiveIcon Icon EventDispatcher Object

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0

SystemTrayIcon sınıfı, Windows^® görev çubuğu bildirim alanı (sistem tepsisi) stilinde simgeyi temsil eder.

AIR profili desteği: Bu özellik masaüstü işletim sistemlerinde desteklenir ancak mobil aygıtlarda veya AIR for TV aygıtlarında desteklenmez. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.

Tüm masaüstü işletim sistemlerinde sistem tepsisi simgesi bulunmaz. Sistem tepsisi simgelerinin geçerli sistemde desteklenip desteklenmediğini belirlemek için NativeApplication.supportsSystemTrayIcon öğesini kontrol edin.

SystemTrayIcon sınıfının bir örneği oluşturulamaz. "global" NativeApplication nesnesinin icon özelliğinden sistem tepsisi simgesini temsil eden nesneyi alın.

Sistem tepsisi simgeleri desteklendiğinde, simge,SystemTrayIcon türünde olacaktır. Aksi takdirde icon türü, InteractiveIcon öğesinin başka bir alt sınıfı olacaktır. Bu da genellikle DockIcon olur.

Önemli: AIR'nin sistem tepsilerini desteklemediği işletim sistemindeki NativeApplication.icon nesnesi üzerinde SystemTrayIcon sınıfı yöntemini çağırmayı denemek, çalışma zamanı istisnası oluşturur.

İlgili API Öğeleri

flash.desktop.NativeApplication.icon
flash.desktop.NativeApplication.supportsSystemTrayIcon
flash.desktop.DockIcon

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		bitmaps : Array [geçersiz kıl] Farklı boyutlardaki BitmapData nesnelerinin bir dizisi olarak simge görüntüsü.	SystemTrayIcon
		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.	SystemTrayIcon
		menu : NativeMenu Sistem tepsisi simge menüsü.	SystemTrayIcon
		tooltip : String Sistem tepsisi simgesi için açılan araç ipucu.	SystemTrayIcon
		width : int [geçersiz kıl] [salt okunur] Simgenin piksel cinsinden geçerli görüntüleme genişliği.	SystemTrayIcon

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	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
		dispatchEvent(event:Event):Boolean Olay akışına bir olay gönderir.	EventDispatcher
		hasEventListener(type:String):Boolean EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.	EventDispatcher
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher nesnesinden bir dinleyiciyi kaldırır.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String Belirtilen nesnenin dize olarak temsil edilen halini döndürür.	Object
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object
		willTrigger(type:String):Boolean 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

Olaylar

Olaylarla ilgili daha fazla bilgi için tıklatın

Miras Alınan Olayları Gizle

Miras Alınan Olayları Göster

	Özet	Tanımlayan:
activate	[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.	EventDispatcher
click	Fareye tıklandığında bu SystemTrayIcon nesnesi tarafından gönderilir.	SystemTrayIcon
deactivate	[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.	EventDispatcher
mouseDown	Fare tuşu basılıyken bu SystemTrayIcon nesnesi tarafından gönderilir.	SystemTrayIcon
mouseUp	Fare tuşu basılı değilken bu SystemTrayIcon nesnesi tarafından gönderilir.	SystemTrayIcon
rightClick	Fareye sağ tıklandığında bu SystemTrayIcon nesnesi tarafından gönderilir.	SystemTrayIcon
rightMouseDown	Farenin sağ tuşu basılıyken bu SystemTrayIcon nesnesi tarafından gönderilir.	SystemTrayIcon
rightMouseUp	Farenin sağ tuşu basılı değilken bu SystemTrayIcon nesnesi tarafından gönderilir.	SystemTrayIcon

Genel Sabitler

	Sabit		Tanımlayan:
		MAX_TIP_LENGTH : Number = 63 [statik] Sistem tepsisi simge araç ipucunun izin verilen uzunluğu.	SystemTrayIcon

Özellik Ayrıntısı

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

tooltip

özellik

tooltip:String

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0

Sistem tepsisi simgesi için açılan araç ipucu. Dize, SystemTrayIcon.MAX_TIP_LENGTH öğesinden daha uzunsa, son kısmı kesilir.

Uygulama
public function get tooltip():String
public function set tooltip(value:String):void

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

Olay Ayrıntısı

click

Olay

Olay Nesne Türü: flash.events.ScreenMouseEvent
özellik ScreenMouseEvent.type = flash.events.ScreenMouseEvent.CLICK

Çalışma Zamanı Sürümleri:

AIR 1.0

Fareye tıklandığında bu SystemTrayIcon nesnesi tarafından gönderilir.

ScreenMouseEvent.CLICK sabiti, click olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu ilişkili özelliklere sahiptir:

Özellik	Değer
`buttonDown`	Birincil fare düğmesine basılırsa `true`; aksi takdirde `false`.
`ctrlKey`	Ctrl tuşu etkin olduğunda Windows veya Linux'ta `true`. Ctrl veya Command tuşu etkin olduğunda Mac'te `true`. Aksi takdirde, `false`.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`shiftKey`	Shift tuşu etkinse `true`; etkin değilse `false`.
`commandKey`	Command tuşu etkin olduğunda Mac'te `true`; etkin olmadığında `false`. Windows'ta her zaman `false`.
`controlKey`	Ctrl tuşu etkin olduğunda `true`; etkin olmadığında `false`.
`screenX`	Olayın ekran koordinatlarında gerçekleştiği yatay koordinat.
`screenY`	Olayın ekran koordinatlarında gerçekleştiği dikey koordinat.
`target`	İşaretçi aygıtının altındaki SystemTrayIcon nesnesi.

mouseDown

Olay

Olay Nesne Türü: flash.events.ScreenMouseEvent
özellik ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_DOWN

Çalışma Zamanı Sürümleri:

AIR 1.0

Fare tuşu basılıyken bu SystemTrayIcon nesnesi tarafından gönderilir.

ScreenMouseEvent.MOUSE_DOWN sabiti, mouseDown olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu ilişkili özelliklere sahiptir:

Özellik	Değer
`buttonDown`	Birincil fare düğmesine basılırsa `true`; aksi takdirde `false`.
`ctrlKey`	Ctrl tuşu etkin olduğunda Windows veya Linux'ta `true`. Ctrl veya Command tuşu etkin olduğunda Mac'te `true`. Aksi takdirde, `false`.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`shiftKey`	Shift tuşu etkinse `true`; etkin değilse `false`.
`commandKey`	Command tuşu etkin olduğunda Mac'te `true`; etkin olmadığında `false`. Windows'ta her zaman `false`.
`controlKey`	Ctrl tuşu etkin olduğunda `true`; etkin olmadığında `false`.
`screenX`	Olayın ekran koordinatlarında gerçekleştiği yatay koordinat.
`screenY`	Olayın ekran koordinatlarında gerçekleştiği dikey koordinat.
`target`	İşaretçi aygıtının altındaki SystemTrayIcon nesnesi.

mouseUp

Olay

Olay Nesne Türü: flash.events.ScreenMouseEvent
özellik ScreenMouseEvent.type = flash.events.ScreenMouseEvent.MOUSE_UP

Çalışma Zamanı Sürümleri:

AIR 1.0

Fare tuşu basılı değilken bu SystemTrayIcon nesnesi tarafından gönderilir.

ScreenMouseEvent.MOUSE_UP sabiti, mouseUp olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu ilişkili özelliklere sahiptir:

Özellik	Değer
`buttonDown`	Birincil fare düğmesine basılırsa `true`; aksi takdirde `false`.
`ctrlKey`	Ctrl tuşu etkin olduğunda Windows veya Linux'ta `true`. Ctrl veya Command tuşu etkin olduğunda Mac'te `true`. Aksi takdirde, `false`.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`shiftKey`	Shift tuşu etkinse `true`; etkin değilse `false`.
`commandKey`	Command tuşu etkin olduğunda Mac'te `true`; etkin olmadığında `false`. Windows'ta her zaman `false`.
`controlKey`	Ctrl tuşu etkin olduğunda `true`; etkin olmadığında `false`.
`screenX`	Olayın ekran koordinatlarında gerçekleştiği yatay koordinat.
`screenY`	Olayın ekran koordinatlarında gerçekleştiği dikey koordinat.
`target`	İşaretçi aygıtının altındaki SystemTrayIcon nesnesi.

rightClick

Olay

Olay Nesne Türü: flash.events.ScreenMouseEvent
özellik ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_CLICK

Çalışma Zamanı Sürümleri:

AIR 1.0

Fareye sağ tıklandığında bu SystemTrayIcon nesnesi tarafından gönderilir.

ScreenMouseEvent.RIGHT_CLICK sabiti, rightClick olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu ilişkili özelliklere sahiptir:

Özellik	Değer
`buttonDown`	Birincil fare düğmesine basılırsa `true`; aksi takdirde `false`.
`ctrlKey`	Ctrl tuşu etkin olduğunda Windows veya Linux'ta `true`. Ctrl veya Command tuşu etkin olduğunda Mac'te `true`. Aksi takdirde, `false`.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`shiftKey`	Shift tuşu etkinse `true`; etkin değilse `false`.
`commandKey`	Command tuşu etkin olduğunda Mac'te `true`; etkin olmadığında `false`. Windows'ta her zaman `false`.
`controlKey`	Ctrl tuşu etkin olduğunda `true`; etkin olmadığında `false`.
`screenX`	Olayın ekran koordinatlarında gerçekleştiği yatay koordinat.
`screenY`	Olayın ekran koordinatlarında gerçekleştiği dikey koordinat.
`target`	İşaretçi aygıtının altındaki SystemTrayIcon nesnesi.

rightMouseDown

Olay

Olay Nesne Türü: flash.events.ScreenMouseEvent
özellik ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_DOWN

Çalışma Zamanı Sürümleri:

AIR 1.0

Farenin sağ tuşu basılıyken bu SystemTrayIcon nesnesi tarafından gönderilir.

ScreenMouseEvent.RIGHT_MOUSE_DOWN sabiti, rightMouseDown olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu ilişkili özelliklere sahiptir:

Özellik	Değer
`buttonDown`	Birincil fare düğmesine basılırsa `true`; aksi takdirde `false`.
`ctrlKey`	Ctrl tuşu etkin olduğunda Windows veya Linux'ta `true`. Ctrl veya Command tuşu etkin olduğunda Mac'te `true`. Aksi takdirde, `false`.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`shiftKey`	Shift tuşu etkinse `true`; etkin değilse `false`.
`commandKey`	Command tuşu etkin olduğunda Mac'te `true`; etkin olmadığında `false`. Windows'ta her zaman `false`.
`controlKey`	Ctrl tuşu etkin olduğunda `true`; etkin olmadığında `false`.
`screenX`	Olayın ekran koordinatlarında gerçekleştiği yatay koordinat.
`screenY`	Olayın ekran koordinatlarında gerçekleştiği dikey koordinat.
`target`	İşaretçi aygıtının altındaki SystemTrayIcon nesnesi.

rightMouseUp

Olay

Olay Nesne Türü: flash.events.ScreenMouseEvent
özellik ScreenMouseEvent.type = flash.events.ScreenMouseEvent.RIGHT_MOUSE_UP

Çalışma Zamanı Sürümleri:

AIR 1.0

Farenin sağ tuşu basılı değilken bu SystemTrayIcon nesnesi tarafından gönderilir.

ScreenMouseEvent.RIGHT_MOUSE_UP sabiti, rightMouseUp olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu ilişkili özelliklere sahiptir:

Özellik	Değer
`buttonDown`	Birincil fare düğmesine basılırsa `true`; aksi takdirde `false`.
`ctrlKey`	Ctrl tuşu etkin olduğunda Windows veya Linux'ta `true`. Ctrl veya Command tuşu etkin olduğunda Mac'te `true`. Aksi takdirde, `false`.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`shiftKey`	Shift tuşu etkinse `true`; etkin değilse `false`.
`commandKey`	Command tuşu etkin olduğunda Mac'te `true`; etkin olmadığında `false`. Windows'ta her zaman `false`.
`controlKey`	Ctrl tuşu etkin olduğunda `true`; etkin olmadığında `false`.
`screenX`	Olayın ekran koordinatlarında gerçekleştiği yatay koordinat.
`screenY`	Olayın ekran koordinatlarında gerçekleştiği dikey koordinat.
`target`	İşaretçi aygıtının altındaki SystemTrayIcon nesnesi.

Sabit Ayrıntısı

MAX_TIP_LENGTH

Sabit

public static const MAX_TIP_LENGTH:Number = 63

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0

Sistem tepsisi simge araç ipucunun izin verilen uzunluğu.

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

SystemTrayIcon - AS3

Sınıflar x

bitmaps

height

menu

tooltip

width

click

mouseDown

mouseUp

rightClick

rightMouseDown

rightMouseUp

MAX_TIP_LENGTH