| Paket | flash.display |
| Klass | public class NativeMenuItem |
| Arv | NativeMenuItem  EventDispatcher Object |
| Underklasser | ContextMenuItem |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
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
falseför parameternisSeparator. - 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å anropaaddSubmenu()-metoden till det överordnade NativeMenu-objektet för att skapa objektet och ställa insubmenu-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
trueför parameternisSeparator.
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
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 | ||
| Metod | Definieras med | ||
|---|---|---|---|
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 | |
Skapar en kopia av NativeMenultem-objektet. | NativeMenuItem | ||
|
Skickar en händelse till händelseflödet. | EventDispatcher | |
|
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | |
|
Anger om det finns en egenskap angiven för ett objekt. | Object | |
|
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | |
|
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | |
|
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | |
|
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | |
|
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | |
[åsidosätt]
Returnerar en sträng som innehåller alla egenskaper i NativeMenuItem-objektet. | NativeMenuItem | ||
|
Returnerar det angivna objektets primitiva värde. | Object | |
|
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ändelse | Sammanfattning | Definieras med | ||
|---|---|---|---|---|
| [utsändningshändelse] Skickas när Flash Player eller AIR får operativsystemfokus och blir aktivt. | EventDispatcher | ||
| [utsändningshändelse] Skickas när Flash Player eller AIR förlorar operativsystemfokus och blir inaktivt. | EventDispatcher | ||
| Skickas av detta NativeWindow-objekt omedelbart innan menyn som innehåller objektet visas. | NativeMenuItem | |||
| Skickas av det här NativeMenuItem-objektet när en tangentmotsvarighet trycks ned och omedelbart innan motsvarande meny visas. | NativeMenuItem | |||
| Skickas när ett menyobjekt markeras av användaren. | NativeMenuItem | |||
checked | egenskap |
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 |
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.ALTERNATEKeyboard.COMMANDKeyboard.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):voidRelaterade API-element
label | egenskap |
menu | egenskap |
menu:NativeMenu [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Menyn som innehåller det här objektet.
Implementering
public function get menu():NativeMenu 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):voidRelaterade API-element
NativeMenuItem | () | 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().
label:String (default = " | |
isSeparator:Boolean (default = false)true om en avgränsare ska skapas, annars false.
|
Relaterade API-element
clone | () | metod |
public function clone():NativeMenuItem| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Skapar en kopia av NativeMenultem-objektet.
ReturnerarNativeMenuItem |
toString | () | metod |
displaying | Händelse |
flash.events.Eventegenskap 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 |
flash.events.Eventegenskap 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.
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 |
flash.events.Eventegenskap 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. |
Tue Jun 12 2018, 01:40 PM Z