| Pakket | flash.display |
| Klasse | public class NativeMenuItem |
| Overerving | NativeMenuItem  EventDispatcher Object |
| Subklassen | ContextMenuItem |
| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0 |
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
falsevoor de parameterisSeparatordoorgeeft. - 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
submenuvan het item. U kunt ook de methodeaddSubmenu()van het bovenliggende NativeMenu-object aanroepen om het item te maken en tegelijkertijd de eigenschapsubmenuin te stellen. - Als u een scheiding wilt maken, roept u de constructor NativeMenuItem aan, waarbij u een lege reeks voor de label en
falsevoor de parameterisSeparatordoorgeeft.
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
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 | ||
| Methode | Gedefinieerd door | ||
|---|---|---|---|
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 | |
Hiermee wordt een kopie van het NativeMenuItem-object gemaakt. | NativeMenuItem | ||
|
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | |
|
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | |
|
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | |
|
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | |
|
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | |
|
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | |
|
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | |
|
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | |
[overschrijven]
Retourneert een tekenreeks die alle eigenschappen van het object NativeMenuItem bevat. | NativeMenuItem | ||
|
Retourneert de primitieve waarde van het opgegeven object. | Object | |
|
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher | |
| Gebeurtenis | Overzicht | Gedefinieerd door | ||
|---|---|---|---|---|
| [uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de besturingssysteemfocus krijgt en actief wordt. | EventDispatcher | ||
| [uitgezonden gebeurtenis] Wordt verzonden wanneer Flash Player of de AIR-toepassing de systeemfocus verliest en inactief wordt. | EventDispatcher | ||
| Wordt verzonden door dit object NativeMenuItem vlak voordat het menu met het item wordt weergegeven. | NativeMenuItem | |||
| Verzonden door dit NativeMenuItem-object wanneer op het bijbehorende toetsequivalent wordt gedrukt en direct voordat het menu dat het object bevat wordt weergegeven. | NativeMenuItem | |||
| Wordt verzonden wanneer een menu-item door de gebruiker wordt geselecteerd. | NativeMenuItem | |||
checked | eigenschap |
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 |
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.ALTERNATEKeyboard.COMMANDKeyboard.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):voidVerwante API-elementen
label | eigenschap |
menu | eigenschap |
menu:NativeMenu [alleen-lezen] | Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0 |
Het menu dat dit item bevat.
Implementatie
public function get menu():NativeMenu 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):voidVerwante API-elementen
NativeMenuItem | () | 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().
label:String (default = " | |
isSeparator:Boolean (default = false)true om een scheiding te maken; instellen op false in andere gevallen.
|
Verwante API-elementen
clone | () | methode |
public function clone():NativeMenuItem| Taalversie: | ActionScript 3.0 |
| Runtimeversies: | AIR 1.0 |
Hiermee wordt een kopie van het NativeMenuItem-object gemaakt.
Geretourneerde waardeNativeMenuItem |
toString | () | methode |
displaying | Gebeurtenis |
flash.events.Eventeigenschap 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.
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 |
flash.events.Eventeigenschap 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 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.
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 |
flash.events.Eventeigenschap 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.
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. |
Wed Jun 13 2018, 11:42 AM Z