| Paket | flash.display |
| Klass | public class NativeMenu |
| Arv | NativeMenu  EventDispatcher Object |
| Underklasser | ContextMenu |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Stöd för AIR-profiler: Den här funktionen stöds på alla operativsystem för datorer, men inte på mobilenheter eller enheter med AIR for TV. Du kan testa stödet vid körning med egenskapen NativeMenu.isSupported. På sidan om stöd för AIR-profiler hittar du mer information om API-stöd för flera profiler.
En inbyggd meny är en meny som styrs och ritas av operativsystemet i stället för ditt program. AIR kan användas med följande typer av inbyggda menyer:
-
Programmenyer kan användas i OS X. Använd egenskapen
NativeApplication.supportsMenuför att testa om programmenyer kan användas i operativsystemet. En programmeny visas på menyfältet överst på Mac-skrivbordet. I OS X finns en standardmeny för varje program, men många menykommandon fungerar inte. Du kan lägga till händelseavlyssnare för standardalternativ, ersätta enskilda menyer och alternativ eller ersätta standardmenyn helt. Öppna programmenyobjektet med NativeApplication-egenskapenmenu. -
Window menus kan användas i Windows och Linux. Använd egenskapen
NativeWindow.supportsMenunär du vill testa om fönstermenyer kan användas i operativsystemet. En fönstermeny visas under fönstrets namnrad. Området som menyn upptar är inte en del av fönsterscenen. Program kan inte rita i området. Tilldela en meny till ett fönster med NativeWindow-egenskapenmenu. -
Dock icon menus kan användas i OS X. Använd egenskapen
NativeApplication.supportsDockIconnär du vill testa om dockningsikoner kan användas i operativsystemet. Alternativ på en meny med dockningsikoner visas ovanför operativsystemets standardalternativ. Standardalternativ kan inte öppnas med programkod. Tilldela en meny till egenskapenmenui programmets DockIcon-objekt. -
System tray icon menus kan användas i Windows och de flesta Linux-system. Använd egenskapen
NativeApplication.supportsSystemTrayIconnär du vill testa om systemfältsikoner kan användas i operativsystemet. En systemfältsikonmeny visas som svar på ett högerklick på en ikon, ungefär som en snabbmeny. Tilldela en meny till egenskapenmenui programmets SystemTrayIcon-objekt. -
Context menus kan användas i alla operativsystem. Snabbmenyer visas som svar på en användargränssnittshändelse, t.ex. ett högerklick eller kommandoklick på ett InteractiveObject som visas i programmet. Användargränssnittets mekanism för visning av menyn varierar beroende på operativsystemet och maskinvaran. Tilldela en meny till egenskapen
contextMenui ett InteractiveObject. I AIR kan en snabbmeny skapas med klassen NativeMenu eller ContextMenu. I Flash Player kan bara klassen ContextMenu användas. ContextMenus i AIR har inte inbyggda alternativ, en standardsnabbmeny visas inte. -
Pop-up menus kan användas i alla operativsystem. Popup-menyer har samma funktion som snabbmenyer men visas med menymetoden
display()i stället för som svar på användargränssnittshändelser. En popup-meny är inte kopplad till ett annat objekt. Skapa helt enkelt den inbyggda menyn och anropa metodendisplay().
Ett menyobjekt innehåller menyalternativ. Ett menyalternativ kan vara ett kommando, en undermeny eller en avgränsare. Lägg till menyalternativ till en meny med metoden addItem() eller addItemAt(). Menyalternativens visningsordning motsvarar alternativens ordning i arrayenitems.
Skapa en undermeny genom att lägga till ett menyalternativ i det överordnade menyobjektet. Tilldela menyobjektet som representerar undermenyn till egenskapen submenu för motsvarande menyalternativ i den överordnade menyn.
Obs! Fönstrets och programmets rotmeny får bara innehålla undermenyobjekt. Objekt som inte representerar undermenyer kanske inte visas och är motsatta till vad användaren förväntar sig av denna typ av menyer.
Menyer skickar select-händelser när ett kommandoobjekt i menyn, eller en av dess undermenyer, markeras. (Undermeny- och avgränsarobjekt kan inte markeras.) target-egenskapen i event-objektet refererar det markerade objektet.
Menyer skickar preparing-händelser just innan menyn visas och när en tangentmotsvarighet för en post på menyn trycks ned. Du kan använda denna händelse för att uppdatera menyinnehåll baserat på programmets nuvarande tillstånd.
Obs! Om du använder Flex Framework bör du överväga att använda klassen FlexNativeMenu. Det är vanligtvis lättare att definiera menyer deklarativt i MXML än det är att skriva ActionScript-kod för att skapa menystrukturen steg för steg.
Relaterade API-element
flash.display.NativeMenuItem
flash.display.NativeWindow.menu
flash.desktop.DockIcon
flash.desktop.SystemTrayIcon
flash.desktop.NativeApplication.menu
flash.desktop.NativeApplication.icon
mx.controls.FlexNativeMenu
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper| Egenskap | Definieras med | ||
|---|---|---|---|
 | constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| isSupported : Boolean [statisk] [skrivskyddad]
Anger om någon typ av inbyggd meny stöds på klientsystemet. | NativeMenu | ||
| items : Array
Arrayen med NativeMenuItem-objekt i denna meny. | NativeMenu | ||
| numItems : int [skrivskyddad]
Antalet NativeMenuItem-objekt i denna meny. | NativeMenu | ||
| parent : NativeMenu [skrivskyddad]
Den överordnade menyn. | NativeMenu | ||
| Metod | Definieras med | ||
|---|---|---|---|
Skapar ett nytt NativeMenu-objekt. | NativeMenu | ||
| 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 | |
Lägger till ett menyobjekt längst ned på menyn. | NativeMenu | ||
Infogar ett menyobjekt vid den angivna positionen. | NativeMenu | ||
Lägger till en undermeny till menyn genom att infoga ett nytt menyobjekt. | NativeMenu | ||
Lägger till en undermeny genom att infoga ett nytt menyobjekt vid den angivna positionen. | NativeMenu | ||
Skapar en kopia av menyn och alla objekt. | NativeMenu | ||
Rapporterar om denna meny innehåller det angivna menyobjektet. | NativeMenu | ||
|
Skickar en händelse till händelseflödet. | EventDispatcher | |
Poppar upp denna meny vid den angivna placeringen. | NativeMenu | ||
Hämtar meyobjektet vid det angivna indexvärdet. | NativeMenu | ||
Hämtar menyobjektet med det angivna namnet. | NativeMenu | ||
Hämtar positionen för det angivna objektet. | NativeMenu | ||
|
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 alla objekt från menyn. | NativeMenu | ||
|
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | |
Tar bort det angivna menyobjektet. | NativeMenu | ||
Tar bort och returnerar menyobjektet vid det angivna indexvärdet. | NativeMenu | ||
Flyttar ett menyobjekt till den angivna positionen. | NativeMenu | ||
|
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 | |
|
Returnerar det angivna objektets strängbeteckning. | Object | |
|
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 visas. | NativeMenu | |||
| Skickas av NativeMenu-objektet när en tangentmotsvarighet trycks ned och omedelbart innan menyn visas. | NativeMenu | |||
| Skickas av detta NativeMenu-objekt när ett av dess menyobjekt eller objekt i en av dess underordnade undermenyer markeras. | NativeMenu | |||
isSupported | egenskap |
items | egenskap |
items:Array| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Arrayen med NativeMenuItem-objekt i denna meny.
Arrayen sorteras i visningsordning.
Obs! Den här egenskapen är skrivskyddad i AIR 1.0. Från och med AIR 1.1 är den inte skrivskyddad längre.
Implementering
public function get items():Array public function set items(value:Array):void numItems | egenskap |
parent | egenskap |
parent:NativeMenu [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Den överordnade menyn.
parent till menyobjektet på rotnivå (översta nivån) är null.
Implementering
public function get parent():NativeMenu NativeMenu | () | Konstruktor |
public function NativeMenu()| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Skapar ett nytt NativeMenu-objekt.
addItem | () | metod |
public function addItem(item:NativeMenuItem):NativeMenuItem| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Lägger till ett menyobjekt längst ned på menyn.
När du skapar en snabbmeny kan du lägga till NativeMenuItem- eller ContextMenuItem-objekt. Du bör emellertid bara använda en typ av objekt på en snabbmeny så att alla objekt på menyn har samma egenskaper.
Obs! Om du lägger till ett objekt på en meny kan programmet krascha, om objektets undermeny är inställd på samma meny (och alltså ger upphov till en cirkulär referens).
Parametrar
item:NativeMenuItem — NativeMenuItem-objektet som ska läggas till längst ned på menyn.
|
NativeMenuItem |
Utlöser
ArgumentError — Om item är null.
| |
ArgumentError — Om item ingår på en annan meny.
|
addItemAt | () | metod |
public function addItemAt(item:NativeMenuItem, index:int):NativeMenuItem| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Infogar ett menyobjekt vid den angivna positionen. Placeringen indexeras uppifrån. Ange parametern index till noll om du vill infoga objektet högst upp på menyn. I alla typer av menyer (fönster-, program-, aktivitetsfältsikon-, dockningsikon-, snabb- och popup-menyer) indexeras menyplaceringen uppifrån.
Parametrar
item:NativeMenuItem — NativeMenultem-objektet som ska infogas.
| |
index:int — Den (nollbaserade) position i menyn där menyobjektet ska infogas.
Obs! Om du lägger till ett objekt på en meny kan programmet krascha, om objektets undermeny är inställd på samma meny (och alltså ger upphov till en cirkulär referens). |
NativeMenuItem |
Utlöser
ArgumentError — Om item är null.
| |
ArgumentError — Om item ingår på en annan meny.
| |
RangeError — Om indexet ligger utanför gränsen för menyns items-array.
|
addSubmenu | () | metod |
public function addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Lägger till en undermeny till menyn genom att infoga ett nytt menyobjekt.
Anrop till metoden addSubMenuAt() motsvarar att skapa ett nytt menyobjekt, lägga till det i menyn och tilldela ett NativeMenu-objekt till objektets submenu-egenskap.
Obs! Om du lägger till en meny som en undermeny till sig själv (i en cirkulär referens) kan programmet krascha.
Parametrar
submenu:NativeMenu — NativeMenu-objektet som definierar undermenyn som ska läggas till.
| |
label:String — Visningsetiketten för menyobjektet som ska läggas till.
|
NativeMenuItem — NativeMenuItem-objektet som skapades för undermenyn.
|
addSubmenuAt | () | metod |
public function addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Lägger till en undermeny genom att infoga ett nytt menyobjekt vid den angivna positionen.
Anrop till metoden addSubMenuAt() motsvarar att skapa ett nytt menyobjekt, infoga det vid den önskade positionen i menyn och tilldela ett NativeMenu-objekt till objektets submenu-egenskap.
Obs! Om du lägger till en meny som en undermeny till sig själv (i en cirkulär referens) kan programmet krascha.
Parametrar
submenu:NativeMenu — NativeMenu-objektet som definierar undermenyn som ska läggas till.
| |
index:int — Positionen i arrayen items för denna meny där menyobjektet ska läggas till.
| |
label:String — Visningsetiketten för menyobjektet som ska läggas till.
|
NativeMenuItem — NativeMenuItem-objektet som skapades för undermenyn.
|
clone | () | metod |
public function clone():NativeMenu| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Skapar en kopia av menyn och alla objekt.
ReturnerarNativeMenu |
containsItem | () | metod |
public function containsItem(item:NativeMenuItem):Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Rapporterar om denna meny innehåller det angivna menyobjektet.
Parametrar
item:NativeMenuItem — Det NativeMenuItem-objekt som ska slås upp.
|
Boolean — true om item finns på den här menyn.
|
display | () | metod |
public function display(stage:Stage, stageX:Number, stageY:Number):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Poppar upp denna meny vid den angivna placeringen.
Parametrar
stage:Stage — Stage-objektet där denna meny ska visas.
| |
stageX:Number — Antal pixlar vågrätt, i förhållande till scenens ursprungsläge där den här menyn ska visas.
| |
stageY:Number — Antal pixlar lodrätt, i förhållande till scenens ursprungsläge den här menyn ska visas.
|
getItemAt | () | metod |
public function getItemAt(index:int):NativeMenuItem| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Hämtar meyobjektet vid det angivna indexvärdet.
Parametrar
index:int — Den (nollbaserade) positionen för objektet som ska returneras.
|
NativeMenuItem — NativeMenuItem-objektet vid den angivna positionen i menyn.
|
Utlöser
RangeError — Om index ligger utanför gränsen för menyns items-array.
|
getItemByName | () | metod |
public function getItemByName(name:String):NativeMenuItem| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Hämtar menyobjektet med det angivna namnet.
Obs! name-egenskapen på menyobjektet tilldelas inte som standard.
Parametrar
name:String — Strängen som ska slås upp.
|
NativeMenuItem — NativeMenuItem-objektet med det angivna namnet eller null om inget sådant objekt finns i menyn.
|
getItemIndex | () | metod |
public function getItemIndex(item:NativeMenuItem):int| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Hämtar positionen för det angivna objektet.
Parametrar
item:NativeMenuItem — Det NativeMenuItem-objekt som ska slås upp.
|
int — Den (nollbaserade) positionen för det angivna objektet på den här menyn eller -1, om objektet inte finns på den här menyn.
|
removeAllItems | () | metod |
public function removeAllItems():void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Tar bort alla objekt från menyn.
removeItem | () | metod |
public function removeItem(item:NativeMenuItem):NativeMenuItem| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Tar bort det angivna menyobjektet.
Parametrar
item:NativeMenuItem — NativeMenuItem-objektet som ska tas bort från denna meny.
|
NativeMenuItem |
Utlöser
RangeError — Om item inte finns i denna meny
|
removeItemAt | () | metod |
public function removeItemAt(index:int):NativeMenuItem| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Tar bort och returnerar menyobjektet vid det angivna indexvärdet.
Parametrar
index:int — Den (nollbaserade) positionen för objektet som ska tas bort.
|
NativeMenuItem — NativeMenuItem-objektet som har tagits bort.
|
Utlöser
RangeError — Om index ligger utanför gränsen för denna menys items-array.
|
setItemIndex | () | metod |
public function setItemIndex(item:NativeMenuItem, index:int):void| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 1.0 |
Flyttar ett menyobjekt till den angivna positionen. Objektet läggs till på menyn om det inte redan finns där när den här metoden kallas.
Parametrar
item:NativeMenuItem — NativeMenuItem-objektet som ska flyttas.
| |
index:int — Den (nollbaserade) positionen i menyn dit objektet ska flyttas.
|
Utlöser
RangeError — Om index ligger utanför gränsen för menyns items-array.
|
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 visas.
Avlyssna denna händelse för att uppdatera menyn innan den visas. En displaying-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.
Obs! På Mac OS X, före AIR 2.6, skickade menyer och menyposter en displaying-händelse när användaren tryckte ned en tangentmotsvarighet. (Den här händelsen skickades inte för interaktioner med tangentmotsvarigheter på andra operativsystem.) Från och med AIR 2.6 skickas inte längre displaying-händelser när användaren trycker ned en tangentmotsvarighet. Använd preparing-händelsen i stället.
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 NativeMenu-objektet när en tangentmotsvarighet trycks ned och omedelbart innan menyn visas.
Lyssna efter den här händelsen om du vill uppdatera menyn, antingen innan den visas eller när en tangentmotsvarighet trycks ned av användaren. Händelsen preparing skickas innan tangentmotsvarigheten är fullständigt beräknad. Du kan aktivera, inaktivera, lägga till eller ta bort poster 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 menypost som tilldelats den utlösande tangentmotsvarigheten, 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 av detta NativeMenu-objekt när ett av dess menyobjekt eller objekt i en av dess underordnade undermenyer markeras.
En select-händelse bubblar från ett menyobjekt till dess överordnade meny och vidare upp via den överordnade menykedjan till rotmenyobjektet. target-egenskapen i event-objektet refererar det markerade NativeMenuItem-objektet. currentTarget-egenskapen refererar detta NativeMenu-objekt.
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