NativeMenuItem

Paket	flash.display
Klass	public class NativeMenuItem
Arv	NativeMenuItem EventDispatcher Object
Underklasser	ContextMenuItem

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Klassen NativeMenuItem representerar ett enstaka objekt i en meny.

Ett menyobjekt kan vara ett kommando, en undermeny eller en avgränsare:

Om du vill skapa ett kommandoobjekt anropar du NativeMenuItem-konstruktorn genom att ange en etikettsträng och värdet false för parametern isSeparator.
Om du vill skapa en undermeny skapar du ett kommandoobjekt för den överordnade menyn och tilldelar undermenyns NativeMenu-objekt till objektets submenu-egenskap. Du kan också anropa addSubmenu()-metoden till det överordnade NativeMenu-objektet för att skapa objektet och ställa in submenu-egenskapen på samma gång.
Om du vill skapa en avgränsare anropar du NativeMenuItem-konstruktorn genom att ange en tom etikettsträng och värdet true för parametern isSeparator.

Avlyssna select-händelser på ett objekt eller en överordnad meny för att känna av när ett menykommando är valt. Varken undermenyer eller avgränsare skickar select-händelser. Lyssna efter preparing-händelser (förberedande) för att avgöra när en menypost ska visas eller aktiveras genom motsvarande tangent.

Relaterade API-element

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

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		checked : Boolean Styr om menyobjektet visar en kryssruta.	NativeMenuItem
		constructor : Object En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans.	Object
		data : Object Ett godtyckligt dataobjekt som är associerat med det här menyobjektet.	NativeMenuItem
		enabled : Boolean Styr om menyobjektet är aktiverat.	NativeMenuItem
		isSeparator : Boolean [skrivskyddad] Rapporterar om detta objekt är en avgränsare.	NativeMenuItem
		keyEquivalent : String Tangentbordskombination för detta menyobjekt.	NativeMenuItem
		keyEquivalentModifiers : Array Tangentkodsarray för kombinationsmodifierare.	NativeMenuItem
		label : String Visningssträngen på menyobjektet.	NativeMenuItem
		menu : NativeMenu [skrivskyddad] Menyn som innehåller det här objektet.	NativeMenuItem
		mnemonicIndex : int Placering för kortkommandotecknet i menyobjektet.	NativeMenuItem
		name : String Namnet på menyobjektet.	NativeMenuItem
		submenu : NativeMenu Den undermeny som är associerad med det här menyobjektet.	NativeMenuItem

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		NativeMenuItem(label:String = "", isSeparator:Boolean = false) Skapar ett nytt NativeMenuItem-objekt.	NativeMenuItem
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser.	EventDispatcher
		clone():NativeMenuItem Skapar en kopia av NativeMenultem-objektet.	NativeMenuItem
		dispatchEvent(event:Event):Boolean Skickar en händelse till händelseflödet.	EventDispatcher
		hasEventListener(type:String):Boolean Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse.	EventDispatcher
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Tar bort en avlyssnare från EventDispatcher-objektet.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String [åsidosätt] Returnerar en sträng som innehåller alla egenskaper i NativeMenuItem-objektet.	NativeMenuItem
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object
		willTrigger(type:String):Boolean Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen.	EventDispatcher

Händelser

Klicka för mer information om händelser

Dölj ärvda händelser

Visa ärvda händelser

	Sammanfattning	Definieras med
activate	[utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt.	EventDispatcher
deactivate	[utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt.	EventDispatcher
displaying	Skickas av detta NativeWindow-objekt omedelbart innan menyn som innehåller objektet visas.	NativeMenuItem
preparing	Skickas av det här NativeMenuItem-objektet när en tangentmotsvarighet trycks ned och omedelbart innan motsvarande meny visas.	NativeMenuItem
select	Skickas när ett menyobjekt markeras av användaren.	NativeMenuItem

Egenskapsdetaljer

checked

egenskap

checked:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Styr om menyobjektet visar en kryssruta.

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

data

egenskap

data:Object

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Ett godtyckligt dataobjekt som är associerat med det här menyobjektet.

Du kan lägga vilket objekt som helst till denna egenskap. Det tilldelade objektet används inte av menysystemet, men finns tillgängligt för händelsehanteringskod (via target-egenskapen i event-objektet). Som standard är värdet för egenskapen null.

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

enabled

egenskap

enabled:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Styr om menyobjektet är aktiverat.

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

isSeparator

egenskap

isSeparator:Boolean [skrivskyddad]

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Rapporterar om detta objekt är en avgränsare.

Skapa en avgränsare genom att ställa in isSeparator-parametern i NativeMenuItem-konstruktorn till true.

Implementering
public function get isSeparator():Boolean

keyEquivalent

egenskap

keyEquivalent:String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Tangentbordskombination för detta menyobjekt.

Ange keyEquivalent med en gemen bokstav för att tilldela ett kortkommando utan en skifttangentmodifierare. Ange med en versal bokstav för att tilldela ett kortkommando med en skifttangentmodifierare.

Som standard är en kombinationsmodifierare (Ctrl i Windows eller Linux och Kommando i Mac OS X) del i tangentkombinationen. Om du vill att tangentbordskombinationen ska vara en tangent utan funktionstangentkombination ska keyEquivalentModifiers-egenskapen ställas in till en tom array.

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

keyEquivalentModifiers

egenskap

keyEquivalentModifiers:Array

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Tangentkodsarray för kombinationsmodifierare.

Använd de konstanter som har definierats i klassen Keyboard för att ange koder för modifieringstangenter. Giltiga modifieringstangenter är:

Keyboard.ALTERNATE
Keyboard.COMMAND
Keyboard.CONTROL

Om du inte tilldelar några modifierare tilldelas som standard tangenten Keyboard.CONTROL i Windows eller Linux och Keyboard.COMMAND i Mac OS X. Om du inte vill att tangentmotsvarigheterna ska ha dessa modifierare ska denna egenskap ställas in till en tom array.

Om du tilldelar en versal bokstav keyEquivalent-egenskapen används Skift-tangenten automatiskt som modifierare. Om du anger keyEquivalentModifier till en tom array tas inte Skift-tangenten bort som modifierare.

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

Relaterade API-element

flash.ui.Keyboard

label

egenskap

label:String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Visningssträngen på menyobjektet.

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

mnemonicIndex

egenskap

mnemonicIndex:int

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Placering för kortkommandotecknet i menyobjektet.

Tecknet vid den angivna positionen är kortkommandotecknet för menyobjektet. Indexet är nollbaserat, så det första tecknet har index 0.

Denna egenskap ignoreras på operativssytem som inte använder kortkommandon.

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

name

egenskap

name:String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Namnet på menyobjektet.

Namnvärdet visas inte och kan användas som en språkinställningsoberoende identifierare. Ett namn tilldelas inte automatiskt.

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

submenu

egenskap

submenu:NativeMenu

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Den undermeny som är associerad med det här menyobjektet.

Att tilldela ett NativeMenu-objekt till den här egenskapen ändrar uppträdandet hos menyobjektet. Ett undermenyobjekt visar undermenyikonen och skickar inte längre select-händelser.

Obs! Om du lägger till en meny som en undermeny till sig själv (i en cirkulär referens) kan programmet krascha.

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

Relaterade API-element

flash.display.NativeMenu.addSubmenu()

Konstruktordetaljer

()

Konstruktor

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

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Skapar ett nytt NativeMenuItem-objekt.

Om du vill skapa ett menykommando ska parametern label anges till en sträng som innehåller visningsetiketten. Parametern isSeparator ska anges till false.

Om du vill skapa ett kommando på en undermeny skapar du ett kommandoobjekt och tilldelar sedan NativeMenu-objektet för undermenyn till objektets submenu-egenskap. Lägg till objektet på den överordnade menyn.

Om du vill skapa en avgränsare ska label-parametern ställas in på en tom sträng och isSeparator ska ställas in till false.

Lägg till och ta bort objekt från en meny med NativeMenu-metoderna addItem() och removeItem().

Parametrar

	`label:String` (default = "") — Visningsetikett för objektet eller en tom sträng för avgränsare.

	`isSeparator:Boolean` (default = `false`) — Värdet är `true` om en avgränsare ska skapas, annars `false`.

Relaterade API-element

flash.display.NativeMenu.addSubmenu()

Metoddetaljer

clone

()

metod

public function clone():NativeMenuItem

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Skapar en kopia av NativeMenultem-objektet.

Returnerar

NativeMenuItem

toString

()

metod

override public function toString():String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Returnerar en sträng som innehåller alla egenskaper i NativeMenuItem-objektet.

Returnerar

String — En sträng som innehåller alla Event-objektets egenskaper.

Händelsedetaljer

displaying

Händelse

Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.DISPLAYING

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Skickas av detta NativeWindow-objekt omedelbart innan menyn som innehåller objektet visas.

Preparing-händelsen åsidosätter displaying-händelsen och tillhandahåller ytterligare funktioner. Lyssna efter händelsen preparing eller displaying, men inte efter båda.

Event.DISPLAYING-konstanten definierar värdet på type-egenskapen i ett displaying-händelseobjekt.

Obs! Den här händelsen går inte igenom en "capture phase" utan skickas direkt till målet, oavsett om målet finns i visningslistan eller ej.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	Objektet som kommer att visas.

preparing

Händelse

Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.PREPARING

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 2.6

Skickas av det här NativeMenuItem-objektet när en tangentmotsvarighet trycks ned och omedelbart innan motsvarande meny visas.

Lyssna efter den här händelsen om du vill uppdatera objektet, antingen innan motsvarande meny visas eller när tangentmotsvarigheten trycks ned av användaren. Händelsen preparing skickas innan tangentmotsvarigheten är fullständigt beräknad. Du kan aktivera, inaktivera eller ta bort posten från menyn i preparing-händelsehanteraren, och sådana ändringar är genomförda när tangentmotsvarigheten bearbetas. Om du till exempel tar bort eller inaktiverar den här menyposten avbryts händelsesekvensen och ingen select-händelse skickas. En preparing-händelse skickas även av andra poster på en meny.

Preparing-händelsen åsidosätter displaying-händelsen och tillhandahåller ytterligare funktioner. Lyssna efter händelsen preparing eller displaying, men inte efter båda.

Konstanten Event.PREPARING definierar värdet för type-egenskapen för ett preparing-händelseobjekt.

Obs! Den här händelsen går inte igenom en "capture phase" utan skickas direkt till målet, oavsett om målet finns i visningslistan eller ej.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	Det objekt som skickade den här händelsen.
`target`	Det objekt som skickade den här händelsen.

select

Händelse

Typ av händelseobjekt: flash.events.Event
egenskap Event.type = flash.events.Event.SELECT

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

AIR 1.0

Skickas när ett menyobjekt markeras av användaren.

En select-händelse bubblar från detta objekt till den aktuella menyn och vidare upp via den överordnade menyn till rotmenyobjektet. Egenskapen target i event-objektet refererar till detta NativeMenuItem-objekt. Egenskapen currentTarget refererar till det objekt som skickas (antingen detta NativeMenuItem eller ett tidigare NativeMenu-objekt).

Obs! Om det fönster som innehåller menyn är i helskärmsläge (stage.displayState == StageDisplayState.FULL_SCREEN) skickar objektet NativeMenuItem inte en select-händelse när användaren anger en tangentbordsmotsvarighet till en menypost.

Event.SELECT-konstanten definierar värdet på type-egenskapen i ett select-händelseobjekt.

Den här händelsen har följande egenskaper:

Egenskap	Värde
`bubbles`	`false`
`cancelable`	`false`; det finns inget standardbeteende att avbryta.
`currentTarget`	Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare.
`target`	Objektet för vilket ett objekt har valts.

Juridiska meddelanden | Onlinesekretesspolicy

NativeMenuItem - AS3

Klasser x

checked

data

enabled

isSeparator

keyEquivalent

keyEquivalentModifiers

label

menu

mnemonicIndex

name

submenu

NativeMenuItem

clone

toString

displaying

preparing

select