NativeMenuItem

Paket	flash.display
Sınıf	public class NativeMenuItem
Miras Alma	NativeMenuItem EventDispatcher Object
Alt Sınıflar	ContextMenuItem

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

NativeMenuItem sınıfı, bir menüdeki tek öğeyi temsil eder.

Bir menü öğesi, komut, alt menü veya ayırıcı çizgi olabilir:

Bir komut öğesi oluşturmak üzere etiket için bir dizeye ileterek NativeMenuItem yapıcısını ve isSeparator parametresi için false öğesini çağırın.
Bir alt menü oluşturmak üzere üst menü için bir komut öğesi oluşturun ve alt menünün NativeMenu nesnesini öğenin submenu özelliğine atayın. Ayrıca üst NativeMenu nesnesinin addSubmenu() yöntemini kullanarak öğeyi oluşturabilir ve aynı zamanda submenu özelliğini de ayarlayabilirsiniz.
Bir ayırıcı oluşturmak üzere etiket için boş bir dizeye ileterek NativeMenuItem yapıcısını ve isSeparator parametresi için true öğesini çağırın.

Bir öğe veya üst menü üzerindeki komut seçildiğinde algılamak için select olaylarını dinler. Ne alt menüler ne de ayırıcılar olayları göndermez. Bir menü öğesinin ne zaman görüntülenmek üzere olduğunu veya bir tuş eşdeğeri yoluyla etkinleştirmek üzere olduğunu belirlemek için preparing olaylarını dinleyin.

İlgili API Öğeleri

flash.display.NativeMenu
flash.display.NativeMenu.addSubmenu()

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		checked : Boolean Bu menü öğesinin bir onay işareti görüntüleyip görüntülemediğini kontrol eder.	NativeMenuItem
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object
		data : Object Bu menü öğesiyle ilişkili rastgele bir veri nesnesi.	NativeMenuItem
		enabled : Boolean Bu menü öğesinin etkinleştirilip etkinleştirilmediğini kontrol eder.	NativeMenuItem
		isSeparator : Boolean [salt okunur] Bu öğenin bir menü ayırıcı çizgi olup olmadığını bildirir.	NativeMenuItem
		keyEquivalent : String Bu menü öğesinin tuş karşılığı.	NativeMenuItem
		keyEquivalentModifiers : Array Tuş karşılığı değiştiricileri için tuş kodları dizisi.	NativeMenuItem
		label : String Bu menü öğesinin görüntüleme dizesi.	NativeMenuItem
		menu : NativeMenu [salt okunur] Bu öğeyi içeren menü.	NativeMenuItem
		mnemonicIndex : int Menü öğesi etiketindeki hatırlatıcı karakterin konumu.	NativeMenuItem
		name : String Bu menü öğesinin adı.	NativeMenuItem
		submenu : NativeMenu Bu menü öğesiyle ilişkili alt menü.	NativeMenuItem

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		NativeMenuItem(label:String = "", isSeparator:Boolean = false) Yeni bir NativeMenuItem nesnesi oluşturur.	NativeMenuItem
		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
		clone():NativeMenuItem NativeMenuItem nesnesinin bir kopyasını oluşturur.	NativeMenuItem
		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 [geçersiz kıl] NativeMenuItem nesnesinin tüm özelliklerini içeren bir dize döndürür.	NativeMenuItem
		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
deactivate	[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.	EventDispatcher
displaying	Öğeyi içeren menü görüntülenmeden hemen önce bu NativeMenuItem nesnesi tarafından gönderilir.	NativeMenuItem
preparing	Tuşun eşdeğerine basıldığında ve kapsayıcı menü görüntülenmeden hemen önce bu NativeMenuItem nesnesi tarafından gönderilir.	NativeMenuItem
select	Bir menü öğesi, kullanıcı tarafından her seçildiğinde gönderilir.	NativeMenuItem

Özellik Ayrıntısı

checked

özellik

checked:Boolean

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Bu menü öğesinin bir onay işareti görüntüleyip görüntülemediğini kontrol eder.

Uygulama
public function get checked():Boolean
public function set checked(value:Boolean):void

data

özellik

data:Object

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Bu menü öğesiyle ilişkili rastgele bir veri nesnesi.

Bu özelliğe herhangi bir nesne atayabilirsiniz. Atanan nesne, menü sistemi tarafından kullanılmaz, ancak olay işleme kodu için kullanılabilir (olay nesnesinin target özelliğiyle). Varsayılan olarak bu özelliğin değeri null olur.

Uygulama
public function get data():Object
public function set data(value:Object):void

enabled

özellik

enabled:Boolean

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Bu menü öğesinin etkinleştirilip etkinleştirilmediğini kontrol eder.

Uygulama
public function get enabled():Boolean
public function set enabled(value:Boolean):void

isSeparator

özellik

isSeparator:Boolean [salt okunur]

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Bu öğenin bir menü ayırıcı çizgi olup olmadığını bildirir.

NativeMenuItem yapıcısındaki isSeparator parametresini true olarak ayarlayıp bir ayırıcı çizgi oluşturun.

Uygulama
public function get isSeparator():Boolean

keyEquivalent

özellik

keyEquivalent:String

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Bu menü öğesinin tuş karşılığı.

Shift tuşu değiştiricisi olmadan bir kısayol atamak için keyEquivalent öğesini küçük harfle ayarlayın. Shift tuşu değiştiricisiyle bir kısayol atamak için büyük bir harfle atayın.

Varsayılan olarak bir tuş karşılığı değiştiricisi (Windows veya Linux'ta Ctrl ve Mac OS X'te Command), tuş karşılığının bir parçası olarak dahil edilmiştir. Tuş karşılığının değiştiriciye sahip olmayan bir tuş olmasını istiyorsanız, keyEquivalentModifiers özelliğini boş bir diziye ayarlayın.

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

keyEquivalentModifiers

özellik

keyEquivalentModifiers:Array

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Tuş karşılığı değiştiricileri için tuş kodları dizisi.

Değiştirici tuş kodlarını belirtmek için Keyboard sınıfında tanımlanan sabitleri kullanın. Geçerli değiştirici tuşları arasında şunlar vardır:

Keyboard.ALTERNATE
Keyboard.COMMAND
Keyboard.CONTROL

Herhangi bir değiştirici atamadığınızda, Windows veya Linux'ta Keyboard.CONTROL tuşu ve Mac OS X'te Keyboard.COMMAND tuşu atanır. Tuş karşılığının bu değiştiricileri içermesini istemiyorsanız, bu özelliği boş bir dizi olarak ayarlayın.

keyEquivalent özelliğine bir büyük harf atarsanız, Shift tuşu otomatik olarak bir değiştirici olarak kullanılır. keyEquivalentModifier özelliğini boş bir diziye ayarlanmanız, Shift tuşunun değiştirici olma özelliğini kaldırmaz.

Uygulama
public function get keyEquivalentModifiers():Array
public function set keyEquivalentModifiers(value:Array):void

İlgili API Öğeleri

flash.ui.Keyboard

label

özellik

label:String

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Bu menü öğesinin görüntüleme dizesi.

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

mnemonicIndex

özellik

mnemonicIndex:int

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Menü öğesi etiketindeki hatırlatıcı karakterin konumu.

Belirtilen konumdaki karakter, menü öğesine ait hatırlatıcı karakterdir. Dizin, sıfır temellidir, dolayısıyla ilk karakter bir 0 dizinine sahiptir.

Bu özellik, menü hatırlatıcısı kullanan işletim sistemlerinde göz ardı edilir.

Uygulama
public function get mnemonicIndex():int
public function set mnemonicIndex(value:int):void

name

özellik

name:String

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Bu menü öğesinin adı.

Ad değeri görüntülenmez ve bir yerel, bağımsız kimlik olarak kullanılabilir. Bir ad, otomatik olarak atanmaz.

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

submenu

özellik

submenu:NativeMenu

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Bu menü öğesiyle ilişkili alt menü.

Bu özelliğe bir NativeMenu Nesnesi atanması, menü öğesinin görünümünü ve davranışını değiştirir. Bir alt menü öğesi, alt menü öğesi simgesini görüntüler ve artık select olaylarını göndermez.

Not: Bir menünün kendi alt menüsü olarak eklenmesi (dairesel başvuruda), uygulamanın askıya alınmasına neden olabilir.

Uygulama
public function get submenu():NativeMenu
public function set submenu(value:NativeMenu):void

İlgili API Öğeleri

flash.display.NativeMenu.addSubmenu()

Yapıcı Ayrıntı

()

Yapıcı

public function NativeMenuItem(label:String = "", isSeparator:Boolean = false)

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Yeni bir NativeMenuItem nesnesi oluşturur.

Yeni bir menü komutu oluşturmak için label parametresini görüntüleme etiketini içeren bir dizeye ayarlayın ve isSeparator öğesini false olarak ayarlayın.

Bir alt menü komutu oluşturmak için, bir komut öğesi oluşturun ve alt menüye ait NativeMenu nesnesini öğenin submenu özelliğine atayın. Öğeyi üst menüye ekleyin.

Bir ayırıcı oluşturmak için label parametresini boş bir dizeye ayarlayın ve isSeparator öğesini true olarak ayarlayın.

NativeMenu addItem() ve removeItem() yöntemlerini kullanarak bir menüye öğe ekleyin veya bir menüden öğeyi kaldırın.

Parametreler

	`label:String` (default = "") — Öğe için görüntüleme etiketi veya ayırıcılar için boş bir dize.

	`isSeparator:Boolean` (default = `false`) — Ayırıcı oluşturmak için `true` olarak ayarlanır; aksi takdirde `false` olarak ayarlanır.

İlgili API Öğeleri

flash.display.NativeMenu.addSubmenu()

Yöntem Ayrıntısı

clone

()

yöntem

public function clone():NativeMenuItem

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

NativeMenuItem nesnesinin bir kopyasını oluşturur.

Döndürür

NativeMenuItem

toString

()

yöntem

override public function toString():String

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

NativeMenuItem nesnesinin tüm özelliklerini içeren bir dize döndürür.

Döndürür

String — Event nesnesinin tüm özelliklerini içeren bir dize.

Olay Ayrıntısı

displaying

Olay

Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.DISPLAYING

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Öğeyi içeren menü görüntülenmeden hemen önce bu NativeMenuItem nesnesi tarafından gönderilir.

preparing olayı, displaying olayının yerini alır ve ek işlevsellik sağlar. preparing olayını veya displaying olayını dinleyin, ancak her ikisini aynı anda dinlemeyin.

Event.DISPLAYING sabiti, bir displaying olayı nesnesinin type özelliğini tanımlar.

Not: Bu olay “yakalama aşamasından“ geçmez ve hedef görüntüleme listesinde olsa da olmasa da, doğrudan hedefe gönderilir.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`target`	Görüntülenmek üzere olan nesne.

preparing

Olay

Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.PREPARING

Dil Sürümü:

ActionScript 3.0

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

AIR 2.6

Tuşun eşdeğerine basıldığında ve kapsayıcı menü görüntülenmeden hemen önce bu NativeMenuItem nesnesi tarafından gönderilir.

Kapsayıcı menü görüntülenmeden önce veya tuş eşdeğerine kullanıcı tarafından basıldığında öğeyi güncellemek için bu olayı dinleyin. Tuş eşdeğeri tamamen değerlendirilmeden önce preparing olayı gönderilir. preparing olay işleyicisindeki menüden öğeyi etkinleştirebilir, devre dışı bırakabilir veya kaldırabilirsiniz; bu değişiklikler de tuş eşdeğeri işlendiğinde geçerli olur. Örneğin, bu menü öğesini kaldırır veya devre dışı bırakırsanız, olayların sırası etkili şekilde iptal edilir ve herhangi bir select olayı gönderilmez. Menüdeki diğer öğeler tarafından bir preparing olayı da gönderilir.

preparing olayı, displaying olayının yerini alır ve ek işlevsellik sağlar. preparing olayını veya displaying olayını dinleyin, ancak her ikisini aynı anda dinlemeyin.

Event.PREPARING sabiti, bir preparing olayı nesnesinin type özelliğinin değerini tanımlar.

Not: Bu olay “yakalama aşamasından“ geçmez ve hedef görüntüleme listesinde olsa da olmasa da, doğrudan hedefe gönderilir.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	Bu olayı gönderen nesne.
`target`	Bu olayı gönderen nesne.

select

Olay

Olay Nesne Türü: flash.events.Event
özellik Event.type = flash.events.Event.SELECT

Dil Sürümü:

ActionScript 3.0

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

AIR 1.0

Bir menü öğesi, kullanıcı tarafından her seçildiğinde gönderilir.

Bu öğeden kapsayıcı menüye ve daha sonra da üst menü zincirinden kök menü nesnesine bir select olayı verilir. Olay nesnesinin target özelliği, bu NativeMenuItem nesnesine başvurur; currentTarget özelliği, gönderen nesneye (bu NativeMenuItem veya geçmişteki bir NativeMenu nesnesi) başvurur.

Not: Menüyü içeren pencere tam ekran modundaysa (stage.displayState == StageDisplayState.FULL_SCREEN), kullanıcı bir menü öğesi için klavye eşdeğeri girdiğinde NativeMenuItem nesnesi bir select olayı göndermez.

Event.SELECT sabiti, select olay nesnesinin type özelliği değerini tanımlar.

Bu olay şu özelliklere sahiptir:

Özellik	Değer
`bubbles`	`false`
`cancelable`	`false`; iptal edilecek varsayılan davranış yoktur.
`currentTarget`	Bu Event nesnesini olay dinleyicisiyle etkin olarak işleyen nesne.
`target`	Üzerinde bir öğenin seçildiği nesne.

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

NativeMenuItem - AS3

Sınıflar x

checked

data

enabled

isSeparator

keyEquivalent

keyEquivalentModifiers

label

menu

mnemonicIndex

name

submenu

NativeMenuItem

clone

toString

displaying

preparing

select