NativeMenuItem

Pakket	flash.display
Klasse	public class NativeMenuItem
Overerving	NativeMenuItem EventDispatcher Object
Subklassen	ContextMenuItem

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

De klasse NativeMenuItem staat voor één item in een menu.

Een item in een menu kan een opdracht, een submenu of een scheidingsregel zijn:

Als u een opdrachtitem wilt maken, roept u de constructor NativeMenuItem aan, waarbij u een reeks voor de label en false voor de parameter isSeparator doorgeeft.
Een submenu maakt u door een opdrachtitem voor het bovenliggende menu te maken en het object NativeMenu van het submenu toe te wijzen aan de eigenschap submenu van het item. U kunt ook de methode addSubmenu() van het bovenliggende NativeMenu-object aanroepen om het item te maken en tegelijkertijd de eigenschap submenu in te stellen.
Als u een scheiding wilt maken, roept u de constructor NativeMenuItem aan, waarbij u een lege reeks voor de label en false voor de parameter isSeparator doorgeeft.

Luister naar select-gebeurtenissen in een item of een bovenliggend menu om vast te stellen wanneer een menuopdracht is geselecteerd. Submenu's noch scheidingen verzenden select-gebeurtenissen. Als u wilt vaststellen wanneer een menu-item wordt weergegeven of geactiveerd met behulp van een toetsequivalent, moet u luisteren naar preparing-gebeurtenissen.

Verwante API-elementen

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

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		checked : Boolean Bepaalt of dit menu-item een vinkje weergeeft.	NativeMenuItem
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		data : Object Een willekeurig gekozen gegevensobject dat aan dit menu-item is gekoppeld.	NativeMenuItem
		enabled : Boolean Bepaalt of dit menu-item wordt ingeschakeld.	NativeMenuItem
		isSeparator : Boolean [alleen-lezen] Meldt of dit item een menuscheidingsregel is.	NativeMenuItem
		keyEquivalent : String Het toetsequivalent van dit menu-item.	NativeMenuItem
		keyEquivalentModifiers : Array De array van toetscodes voor de toetsequivalent-modifiers.	NativeMenuItem
		label : String De weergavereeks van dit menu-item.	NativeMenuItem
		menu : NativeMenu [alleen-lezen] Het menu dat dit item bevat.	NativeMenuItem
		mnemonicIndex : int De positie van het mnemonic-teken in de label van het menu-item.	NativeMenuItem
		name : String De naam van dit menu-item.	NativeMenuItem
		submenu : NativeMenu Het submenu dat aan dit menu-item is gekoppeld.	NativeMenuItem

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		NativeMenuItem(label:String = "", isSeparator:Boolean = false) Hiermee wordt een nieuw NativeMenuItem-object gemaakt.	NativeMenuItem
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt.	EventDispatcher
		clone():NativeMenuItem Hiermee wordt een kopie van het NativeMenuItem-object gemaakt.	NativeMenuItem
		dispatchEvent(event:Event):Boolean Verzendt een gebeurtenis naar de gebeurtenisstroom.	EventDispatcher
		hasEventListener(type:String):Boolean Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis.	EventDispatcher
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Verwijdert een listener uit het object EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String [overschrijven] Retourneert een tekenreeks die alle eigenschappen van het object NativeMenuItem bevat.	NativeMenuItem
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object
		willTrigger(type:String):Boolean Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis.	EventDispatcher

Gebeurtenissen

Klik voor meer informatie over gebeurtenissen.

Overerfde gebeurtenissen verbergen

Overerfde gebeurtenissen weergeven

	Overzicht	Gedefinieerd door
activate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt.	EventDispatcher
deactivate	[uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt.	EventDispatcher
displaying	Wordt verzonden door dit object NativeMenuItem vlak voordat het menu met het item wordt weergegeven.	NativeMenuItem
preparing	Verzonden door dit NativeMenuItem-object wanneer op het bijbehorende toetsequivalent wordt gedrukt en direct voordat het menu dat het object bevat wordt weergegeven.	NativeMenuItem
select	Wordt verzonden wanneer een menu-item door de gebruiker wordt geselecteerd.	NativeMenuItem

Eigenschapdetails

checked

eigenschap

checked:Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Bepaalt of dit menu-item een vinkje weergeeft.

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

data

eigenschap

data:Object

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Een willekeurig gekozen gegevensobject dat aan dit menu-item is gekoppeld.

U kunt elk gewenst object aan deze eigenschap toewijzen. Het toegewezen object wordt niet door het menusysteem gebruikt, maar is beschikbaar voor gebeurtenisafhandelingscode (via de eigenschap target van het gebeurtenisobject). De standaardwaarde van deze eigenschap is null.

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

enabled

eigenschap

enabled:Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Bepaalt of dit menu-item wordt ingeschakeld.

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

isSeparator

eigenschap

isSeparator:Boolean [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Meldt of dit item een menuscheidingsregel is.

U maakt een scheidingsregel door de parameter isSeparator in de constructor NativeMenuItem in te stellen op true.

Implementatie
public function get isSeparator():Boolean

keyEquivalent

eigenschap

keyEquivalent:String

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Het toetsequivalent van dit menu-item.

Stel de keyEquivalent in met een kleine letter om een snelkoppeling toe te wijzen zonder Shift-toetswijziging. Stel deze in met een hoofdletter als u een snelkoppeling met de Shift-toetswijziging wilt toewijzen.

Standaard maakt een toetsequivalent-modifier (Ctrl bij Windows of Linux en Command bij Mac OS X) deel uit van het toetsequivalent. Als u wilt dat de toetsequivalent een toets zonder optietoets is, stelt u de eigenschap keyEquivalentModifiers in op een lege array.

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

keyEquivalentModifiers

eigenschap

keyEquivalentModifiers:Array

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

De array van toetscodes voor de toetsequivalent-modifiers.

Gebruik de constanten die zijn gedefinieerd in de klasse Keyboard om de toetscodes voor de modifier op te geven. Geldige modifier-toetsen zijn:

Keyboard.ALTERNATE
Keyboard.COMMAND
Keyboard.CONTROL

Als u geen optietoetsen toewijst, wordt in Windows of Linux standaard de toets Keyboard.CONTROL toegewezen, en in Mac OS X de toets Keyboard.COMMAND. Als u niet wilt dat deze optietoetsen in de toetsequivalent worden opgenomen, stelt u deze eigenschap in op een lege array.

Als u een hoofdletter toewijst aan de eigenschap keyEquivalent, wordt automatisch Shift als optietoets gebruikt. Door keyEquivalentModifier in te stellen op een lege array, wordt de Shift-toets niet als optietoets verwijderd.

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

Verwante API-elementen

flash.ui.Keyboard

label

eigenschap

label:String

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

De weergavereeks van dit menu-item.

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

mnemonicIndex

eigenschap

mnemonicIndex:int

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

De positie van het mnemonic-teken in de label van het menu-item.

Het teken op de opgegeven positie wordt het mnemonische teken voor het menu-item. De index heeft nul als basis, dus het eerste teken heeft de index 0.

Deze eigenschap wordt genegeerd bij besturingssystemen die geen menu-mnemonics gebruiken.

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

name

eigenschap

name:String

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

De naam van dit menu-item.

De naamwaarde wordt niet weergegeven en kan worden gebruikt als een lokale-onafhankelijke id. Er wordt niet automatisch een naam toegewezen.

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

submenu

eigenschap

submenu:NativeMenu

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Het submenu dat aan dit menu-item is gekoppeld.

Als u een NativeMenu-object aan deze eigenschap toewijst, veranderen de weergave en het gedrag van het menu-item. Een submenu-item geeft het submenupictogram weer en verzendt geen select-gebeurtenissen meer.

Opmerking: wanneer een menu als een submenu van zichzelf wordt toegevoegd (in een cirkelreferentie) kan een toepassing vastlopen.

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

Verwante API-elementen

flash.display.NativeMenu.addSubmenu()

Constructordetails

()

Constructor

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Hiermee wordt een nieuw NativeMenuItem-object gemaakt.

Als u een menuopdracht wilt maken, stelt u de parameter label in op een tekenreeks met de weergavelabel en stelt u isSeparator in op false.

Als u een submenupopdracht wilt maken, maakt u een opdrachtitem en wijst u het object NativeMenu voor het submenu toe aan de eigenschap submenu van het item. Voeg het item aan het bovenliggende menu toe.

Als u een scheiding wilt maken, stelt u de parameter label in op een lege tekenreeks en stelt u isSeparator in op true.

Voeg items toe aan en verwijder deze uit een menu met de NativeMenu-methoden addItem() en removeItem().

Parameters

	`label:String` (default = "") — De weergavelabel voor het item of een lege tekenreeks voor scheidingen.

	`isSeparator:Boolean` (default = `false`) — Instellen op `true` om een scheiding te maken; instellen op `false` in andere gevallen.

Verwante API-elementen

flash.display.NativeMenu.addSubmenu()

Methodedetails

clone

()

methode

public function clone():NativeMenuItem

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Hiermee wordt een kopie van het NativeMenuItem-object gemaakt.

Geretourneerde waarde

NativeMenuItem

toString

()

methode

override public function toString():String

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Retourneert een tekenreeks die alle eigenschappen van het object NativeMenuItem bevat.

Geretourneerde waarde

String — Een tekenreeks geretourneerd die alle eigenschappen van het Event-object bevat.

Gebeurtenisdetails

displaying

Gebeurtenis

Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.DISPLAYING

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Wordt verzonden door dit object NativeMenuItem vlak voordat het menu met het item wordt weergegeven.

De preparing-gebeurtenis heeft een hogere prioriteit dan de displaying-gebeurtenis en biedt extra functionaliteit. U kunt luisteren naar de preparing-gebeurtenis of naar de displaying-gebeurtenis, maar niet naar beide.

De constante Event.DISPLAYING bevat de waarde van de eigenschap type van een displaying-gebeurtenisobject.

Opmerking: deze gebeurtenis gaat niet door een 'vastlegfase' en wordt direct naar het doel verzonden, of het doel zich in het weergaveoverzicht bevindt of niet.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Het object dat wordt weergegeven.

preparing

Gebeurtenis

Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.PREPARING

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2.6

Verzonden door dit NativeMenuItem-object wanneer op het bijbehorende toetsequivalent wordt gedrukt en direct voordat het menu dat het object bevat wordt weergegeven.

Luister naar deze gebeurtenis als u het item wilt bijwerken voordat het menu dat het item bevat wordt weergegeven, of wanneer de gebruiker op het bijbehorende toetsequivalent drukt. De preparing-gebeurtenis wordt verzonden voordat het toetsequivalent volledig is geëvalueerd. U kunt het menu-item inschakelen, uitschakelen of verwijderen in de preparing-gebeurtenishandler. Deze wijzigingen worden toegepast wanneer het toetsequivalent wordt verwerkt. Als u het menu-item bijvoorbeeld verwijdert of uitschakelt, wordt de volgorde van gebeurtenissen feitelijk geannuleerd en wordt er geen select-gebeurtenis verzonden. De overige items in een menu verzenden ook een preparing-gebeurtenis.

De constante Event.PREPARING definieert de waarde van de type-eigenschap van een preparing-gebeurtenisobject.

Opmerking: deze gebeurtenis gaat niet door een 'vastlegfase' en wordt direct naar het doel verzonden, of het doel zich in het weergaveoverzicht bevindt of niet.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	Het object dat deze gebeurtenis heeft verzonden.
`target`	Het object dat deze gebeurtenis heeft verzonden.

select

Gebeurtenis

Type gebeurtenisobject: flash.events.Event
eigenschap Event.type = flash.events.Event.SELECT

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0

Wordt verzonden wanneer een menu-item door de gebruiker wordt geselecteerd.

Een select-gebeurtenis wordt van dit item teruggekoppeld naar het hoger liggende menu en hoger in de menuketen tot aan het hoofdmenuobject. De eigenschap target van het gebeurtenisobject verwijst naar dit NativeMenuItem-object; de eigenschap currentTarget verwijst naar het verzendende object (dit NativeMenuItem of een bovenliggend NativeMenu-object).

Opmerking: Als het venster dat het menu bevat in de volledige-schermmodus wordt weergegeven (stage.displayState == StageDisplayState.FULL_SCREEN), verzendt het NativeMenuItem-object geen select-gebeurtenis wanneer de gebruiker een toetsenbordequivalent van een menu-item invoert.

De constante Event.SELECT definieert de waarde van de eigenschap type van een select-gebeurtenisobject.

Deze gebeurtenis heeft de volgende eigenschappen:

Eigenschap	Waarde
`bubbles`	`false`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`target`	Het object waarop een item is geselecteerd.

Juridische kennisgeving | Online privacybeleid

NativeMenuItem - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket flash.display

checked

data

enabled

isSeparator

keyEquivalent

keyEquivalentModifiers

label

menu

mnemonicIndex

name

submenu

NativeMenuItem

clone

toString

displaying

preparing

select