| Paket | flash.display |
| Klasse | public class NativeMenu |
| Vererbung | NativeMenu  EventDispatcher Object |
| Unterklassen | ContextMenu |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Unterstützung von AIR-Profilen: Diese Funktion wird auf allen Desktopbetriebssystemen unterstützt, jedoch nicht auf mobilen Geräten oder Geräten mit AIR für TV. Mit der NativeMenu.isSupported-Eigenschaft können Sie testen, ob zur Laufzeit Unterstützung gegeben ist. Weitere Informationen zum AIR-Support über mehrere Profile finden Sie unter Unterstützung von AIR-Profilen.
Ein natives Menü ist ein Menü, das nicht von Ihrer Anwendung, sondern vom Betriebssystem gesteuert und gezeichnet wird. AIR unterstützt die folgenden Typen von nativen Menüs:
-
Anwendungsmenüs werden unter OS X unterstützt. Testen Sie mit der
NativeApplication.supportsMenu-Eigenschaft, ob Anwendungsmenüs vom Host-Betriebssystem unterstützt werden. Ein Anwendungsmenü wird in der Menüleiste oben auf dem Mac-Desktop angezeigt. OS X stellt für jede Anwendung ein Standardmenü bereit, viele dieser Menübefehle sind jedoch nicht funktionsfähig. Sie können den Standardelementen Ereignis-Listener hinzufügen, einzelne Menüs und Menüelemente ersetzen oder sogar das gesamte Standardmenü ersetzen. Über diemenu-Eigenschaft von NativeApplication haben Sie Zugriff auf das Anwendungsmenüobjekt. -
Fenstermenüs werden unter Windows und Linux unterstützt. Testen Sie mit der
NativeWindow.supportsMenu-Eigenschaft, ob Fenstermenüs vom Host-Betriebssystem unterstützt werden. Ein Fenstermenü wird unter der Titelleiste eines Fensters angezeigt. Der vom Menü belegte Platz ist nicht Teil der Fensterbühne. Anwendungen können nicht in diesen Bereich zeichnen. Weisen Sie ein Menü mithilfe dermenu-Eigenschaft von NativeWindow einem Fenster zu. -
Docksymbolmenüs werden unter OS X unterstützt. Testen Sie mit der
NativeApplication.supportsDockIcon-Eigenschaft, ob Docksymbole vom Host-Betriebssystem unterstützt werden. Elemente eines Docksymbolmenüs werden über den vom Betriebssystem bereitgestellten Standardelementen angezeigt. Auf die Standardelemente kann nicht mit Anwendungscode zugegriffen werden. Weisen Sie dermenu-Eigenschaft des DockIcon-Objekts der Anwendung ein Menü zu. -
Infobereichsymbolmenüs werden unter Windows und den meisten Linux-Betriebssystemen unterstützt. Testen Sie mit der
NativeApplication.supportsSystemTrayIcon-Eigenschaft, ob Infobereichsymbolmenüs vom Host-Betriebssystem unterstützt werden. Ein Infobereichsymbolmenü wird nach einem Rechtsklick auf das Symbol angezeigt, ähnlich wie ein Kontextmenü. Weisen Sie dermenu-Eigenschaft des SystemTrayIcon-Objekts der Anwendung ein Menü zu. -
Kontextmenüs werden von allen Betriebssystemen unterstützt. Kontextmenüs werden als Reaktion auf ein Benutzeroberflächenereignis angezeigt, zum Beispiel Klicken mit der rechten Maustaste oder bei gedrückter Befehlstaste auf ein InteractiveObject, das in der Anwendung angezeigt wird. Der UI-Mechanismus zum Anzeigen des Menüs variiert je nach Host-Betriebssystem und Hardware. Weisen Sie der
contextMenu-Eigenschaft eines InteractiveObject ein Menü zu. In AIR können Kontextmenüs mit der NativeMenu-Klasse oder der ContextMenu-Klasse erstellt werden. In Flash Player kann nur die ContextMenu-Klasse verwendet werden. ContextMenus in AIR haben keine integrierten Elemente; es wird kein Standardkontextmenü angezeigt. -
Popupmenüs werden von allen Betriebssystemen unterstützt. Popupmenüs haben die gleiche Funktion wie Kontextmenüs, sie werden jedoch mithilfe der Menü-
display()-Methode angezeigt und nicht als Reaktion auf ein Benutzeroberflächenereignis. Ein Popupmenü ist an kein anderes Objekt angehängt. Erstellen Sie einfach das native Menü und rufen Sie diedisplay()-Methode auf.
Ein Menüobjekt enthält Menüelemente. Ein Menüelement kann einen Befehl, ein Untermenü oder eine Trennlinie repräsentieren. Fügen Sie einem Menü mithilfe der addItem()- oder addItemAt()-Methode Menüelemente hinzu. Die Anzeigereihenfolge der Menüelemente entspricht der Reihenfolge der Elemente im items-Array des Menüs.
Um ein Untermenü zu erstellen, fügen Sie dem übergeordneten Menüobjekt ein Menüelement hinzu. Weisen Sie das Menüobjekt, das das Untermenü repräsentiert, der submenu-Eigenschaft des entsprechenden Menüelements im übergeordneten Menü zu.
Hinweis: Das Stammmenü von Fenster- und Anwendungsmenüs darf nur Untermenüelemente enthalten. Elemente, die keine Untermenüs repräsentieren, dürfen nicht angezeigt werden, da dies den Erwartungen der Benutzer für diese Menütypen widersprechen würde.
Menüs lösen select-Ereignisse aus, wenn ein Befehl im Menü oder in einem seiner Untermenüs ausgewählt wird. (Untermenü- und Trennlinienelemente können nicht ausgewählt werden.) Die target-Eigenschaft des Ereignisobjekts verweist auf das ausgewählte Element.
Menüs setzen preparing-Ereignisse ab, kurz bevor das Menü angezeigt wird und wenn eine Tastenentsprechung, die einem der Einträge im Menü zugewiesen wurde, gedrückt wird. Sie können dieses Ereignis verwenden, um den Inhalt des Menüs auf Grundlage des aktuellen Anwendungsstatus zu aktualisieren.
Hinweis: Wenn Sie im Flex-Framework arbeiten, ziehen Sie die Verwendung der FlexNativeMenu-Klasse in Betracht. Es ist normalerweise einfacher, Menüs deklarativ in MXML zu definieren, als ActionScript-Code zu schreiben, um die Menüstruktur Element für Element zu erstellen.
Verwandte API-Elemente
flash.display.NativeMenuItem
flash.display.NativeWindow.menu
flash.desktop.DockIcon
flash.desktop.SystemTrayIcon
flash.desktop.NativeApplication.menu
flash.desktop.NativeApplication.icon
mx.controls.FlexNativeMenu
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| isSupported : Boolean [statisch] [schreibgeschützt]
Gibt an, ob das Clientsystem eine Form des nativen Menüs unterstützt. | NativeMenu | ||
| items : Array
Das Array der NativeMenuItem-Objekte in diesem Menü. | NativeMenu | ||
| numItems : int [schreibgeschützt]
Die Anzahl der NativeMenuItem-Objekte in diesem Menü. | NativeMenu | ||
| parent : NativeMenu [schreibgeschützt]
Das übergeordnete Menü. | NativeMenu | ||
| Methode | Definiert von | ||
|---|---|---|---|
Erstellt ein neues NativeMenu-Objekt. | NativeMenu | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
Fügt am Ende des Menüs ein Menüelement hinzu. | NativeMenu | ||
Fügt an der angegebenen Position ein Menüelement hinzu. | NativeMenu | ||
Fügt dem Menü ein Untermenü hinzu, indem ein neues Menüelement eingefügt wird. | NativeMenu | ||
Fügt dem Menü ein Untermenü hinzu, indem ein neues Menüelement an der angegebenen Position eingefügt wird. | NativeMenu | ||
Erstellt eine Kopie des Menüs und aller Elemente. | NativeMenu | ||
Gibt an, ob dieses Menü das angegebene Menüelement enthält. | NativeMenu | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
Blendet dieses Menü an der angegebenen Position ein. | NativeMenu | ||
Ruft das Menüelement am angegebenen Index ab. | NativeMenu | ||
Ruft das Menüelement mit dem angegebenen Namen ab. | NativeMenu | ||
Ruft die Position des angegebenen Elements ab. | NativeMenu | ||
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
Entfernt alle Elemente aus dem Menü. | NativeMenu | ||
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
Entfernt das angegebene Menüelement. | NativeMenu | ||
Bewirkt, dass das Menüelement am angegebenen Index entfernt und zurückgegeben wird. | NativeMenu | ||
Verschiebt ein Menüelement an die angegebene Position. | NativeMenu | ||
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
| Ereignis | Übersicht | Definiert von | ||
|---|---|---|---|---|
| [broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird. | EventDispatcher | ||
| [broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird. | EventDispatcher | ||
| Wird unmittelbar vor der Anzeige des Menüs von diesem NativeMenu-Objekt abgesetzt. | NativeMenu | |||
| Wird vom NativeMenu-Objekt abgesetzt, wenn eine Tastenentsprechung gedrückt wird, und unmittelbar vor dem Einblenden des Menüs. | NativeMenu | |||
| Wird von diesem NativeMenu-Objekt ausgelöst, wenn eines seiner Menüelemente oder ein Element in einem seiner nachfolgenden Untermenüs ausgewählt wird. | NativeMenu | |||
isSupported | Eigenschaft |
items | Eigenschaft |
items:Array| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das Array der NativeMenuItem-Objekte in diesem Menü.
Das Array wird in der Anzeigereihenfolge sortiert.
Hinweis: Diese Eigenschaft ist in AIR 1.0 schreibgeschützt. In AIR 1.1 wurde der Modus in Lesen/Schreiben geändert.
Implementierung
public function get items():Array public function set items(value:Array):void numItems | Eigenschaft |
parent | Eigenschaft |
parent:NativeMenu [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das übergeordnete Menü.
Der parent-Parameter des Stammmenü-Objekts (oberste Ebene) ist null.
Implementierung
public function get parent():NativeMenu NativeMenu | () | Konstruktor |
public function NativeMenu()| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Erstellt ein neues NativeMenu-Objekt.
addItem | () | Methode |
public function addItem(item:NativeMenuItem):NativeMenuItem| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Fügt am Ende des Menüs ein Menüelement hinzu.
Beim Erstellen eines Kontextmenüs können Sie entweder NativeMenuItem- oder ContextMenuItem-Objekte hinzufügen. Es wird jedoch empfohlen, dass Sie in einem Kontextmenü nur einen Objekttyp verwenden, damit alle Menüelemente über dieselben Eigenschaften verfügen.
Hinweis: Das Hinzufügen eines Elements zu einem Menü kann dazu führren, dass die Anwendung hängen bleibt, wenn das Untermenü des Elements auf das Menü selbst gesetzt ist (Zirkelverweis).
Parameter
item:NativeMenuItem — Das NativeMenuItem-Objekt, das im Menü unten hinzugefügt werden soll.
|
NativeMenuItem |
Auslöser
ArgumentError — Wenn ein item null ist.
| |
ArgumentError — Wenn ein item Mitglied eines anderen Menüs ist.
|
addItemAt | () | Methode |
public function addItemAt(item:NativeMenuItem, index:int):NativeMenuItem| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Fügt an der angegebenen Position ein Menüelement hinzu. Die Position wird von oben nach unten indexiert. Stellen Sie die index-Parameter auf null ein, um das Element oben im Menü einzufügen. Alle Menüarten – Fenster, Anwendung, Taskleistensymbol, Docksymbol, Kontext und Popup – legen den Indexwert der Position im Menü von oben fest.
Parameter
item:NativeMenuItem — Das einzufügende NativeMenuItem-Objekt.
| |
index:int — Die Position in einem Menü (auf null basierend), an der das Menüelement eingefügt wird.
Hinweis: Das Hinzufügen eines Elements zu einem Menü kann dazu führren, dass die Anwendung hängen bleibt, wenn das Untermenü des Elements auf das Menü selbst gesetzt ist (Zirkelverweis). |
NativeMenuItem |
Auslöser
ArgumentError — Wenn ein item null ist.
| |
ArgumentError — Wenn ein item Mitglied eines anderen Menüs ist.
| |
RangeError — Wenn sich die Indexposition außerhalb der Grenzen des items-Arrays des Menüs befindet.
|
addSubmenu | () | Methode |
public function addSubmenu(submenu:NativeMenu, label:String):NativeMenuItem| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Fügt dem Menü ein Untermenü hinzu, indem ein neues Menüelement eingefügt wird.
Das Aufrufen der addSubMenu()-Methode entspricht der Erstellung eines neuen Menüelements, das dem Menü hinzugefügt wird und dessen submenu-Eigenschaft ein NativeMenu-Objekt zugewiesen wird.
Hinweis: Wird ein Menü sich selbst als Untermenü hinzugefügt (Zirkelverweis), kann die Anwendung hängen bleiben.
Parameter
submenu:NativeMenu — Das NativeMenu-Objekt, das das hinzuzufügende Untermenü definiert.
| |
label:String — Die Bezeichnung, die für das hinzuzufügende Menüelement angezeigt werden soll.
|
NativeMenuItem — Das für das Untermenü erstellte NativeMenuItem-Objekt.
|
addSubmenuAt | () | Methode |
public function addSubmenuAt(submenu:NativeMenu, index:int, label:String):NativeMenuItem| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Fügt dem Menü ein Untermenü hinzu, indem ein neues Menüelement an der angegebenen Position eingefügt wird.
Das Aufrufen der addSubMenuAt()-Methode entspricht der Erstellung eines neuen Menüelements, das an der gewünschten Position im Menü eingefügt wird und dessen submenu-Eigenschaft ein NativeMenu-Objekt zugewiesen wird.
Hinweis: Wird ein Menü sich selbst als Untermenü hinzugefügt (Zirkelverweis), kann die Anwendung hängen bleiben.
Parameter
submenu:NativeMenu — Das NativeMenu-Objekt, das das hinzuzufügende Untermenü definiert.
| |
index:int — Die Position im items-Array dieses Menüs, an der das Menüelement hinzugefügt werden soll.
| |
label:String — Die Bezeichnung, die für das hinzuzufügende Menüelement angezeigt werden soll.
|
NativeMenuItem — Das für das Untermenü erstellte NativeMenuItem-Objekt.
|
clone | () | Methode |
public function clone():NativeMenu| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Erstellt eine Kopie des Menüs und aller Elemente.
RückgabewerteNativeMenu |
containsItem | () | Methode |
public function containsItem(item:NativeMenuItem):Boolean| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Gibt an, ob dieses Menü das angegebene Menüelement enthält.
Parameter
item:NativeMenuItem — Das zu suchende NativeMenuItem-Objekt.
|
Boolean — Der Wert ist true, wenn sich item in diesem Menü befindet.
|
display | () | Methode |
public function display(stage:Stage, stageX:Number, stageY:Number):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Blendet dieses Menü an der angegebenen Position ein.
Parameter
stage:Stage — Das Stage-Objekt, für das dieses Menü angezeigt werden soll.
| |
stageX:Number — Die Anzahl horizontaler Pixel in Bezug auf den Ursprungspunkt der Bühne, auf der dieses Menü angezeigt werden soll.
| |
stageY:Number — Die Anzahl vertikaler Pixel in Bezug auf den Ursprungspunkt der Bühne, auf der dieses Menü angezeigt werden soll.
|
getItemAt | () | Methode |
public function getItemAt(index:int):NativeMenuItem| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ruft das Menüelement am angegebenen Index ab.
Parameter
index:int — Die Position (auf Basis von Null) des zurückzugebenden Elements.
|
NativeMenuItem — Das NativeMenuItem-Objekt an der angegebenen Position im Menü.
|
Auslöser
RangeError — Wenn sich index außerhalb der Grenzen des items-Arrays des Menüs befindet.
|
getItemByName | () | Methode |
public function getItemByName(name:String):NativeMenuItem| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ruft das Menüelement mit dem angegebenen Namen ab.
Hinweis: Die name-Eigenschaft von Menüelementen wird standardmäßig nicht zugewiesen.
Parameter
name:String — Der zu suchende String.
|
NativeMenuItem — Das NativeMenuItem-Objekt mit dem angegebenen Namen oder null, wenn kein solches Element im Menü existiert.
|
getItemIndex | () | Methode |
public function getItemIndex(item:NativeMenuItem):int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ruft die Position des angegebenen Elements ab.
Parameter
item:NativeMenuItem — Das zu suchende NativeMenuItem-Objekt.
|
int — Die (auf null basierende) Position des angegebenen Elements in diesem Menü oder -1, wenn das Element nicht in diesem Menü enthalten ist.
|
removeAllItems | () | Methode |
public function removeAllItems():void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Entfernt alle Elemente aus dem Menü.
removeItem | () | Methode |
public function removeItem(item:NativeMenuItem):NativeMenuItem| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Entfernt das angegebene Menüelement.
Parameter
item:NativeMenuItem — Das NativeMenuItem-Objekt, das aus diesem Menü entfernt werden soll.
|
NativeMenuItem |
Auslöser
RangeError — Wenn item nicht in diesem Menü enthalten ist.
|
removeItemAt | () | Methode |
public function removeItemAt(index:int):NativeMenuItem| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Bewirkt, dass das Menüelement am angegebenen Index entfernt und zurückgegeben wird.
Parameter
index:int — Die (auf null basierende) Position des zu entfernenden Elements.
|
NativeMenuItem — Das entfernte NativeMenuItem-Objekt.
|
Auslöser
RangeError — Wenn index sich außerhalb der Grenzen des items-Arrays des Menüs befindet.
|
setItemIndex | () | Methode |
public function setItemIndex(item:NativeMenuItem, index:int):void| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Verschiebt ein Menüelement an die angegebene Position. Ist dieses Element noch nicht im Menü enthalten, wird es diesem durch Aufrufen dieser Methode hinzugefügt.
Parameter
item:NativeMenuItem — Das zu verschiebende NativeMenuItem-Objekt.
| |
index:int — Die (auf null basierende) Position im Menü, an die item verschoben werden soll.
|
Auslöser
RangeError — Wenn sich index außerhalb der Grenzen des items-Arrays des Menüs befindet.
|
displaying | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.DISPLAYING| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Wird unmittelbar vor der Anzeige des Menüs von diesem NativeMenu-Objekt abgesetzt.
Durch Warten auf dieses Ereignis kann das Menü vor der Anzeige aktualisiert werden. Ein displaying-Ereignis wird auch von den Elementen in einem Menü abgesetzt.
Das preparing-Ereignis ersetzt das displaying-Ereignis und stellt zusätzliche Funktionen bereit. Verwenden Sie einen Listener für das preparing-Ereignis oder für das displaying-Ereignis, aber nicht für beide.
Hinweis: Unter Mac OS X haben Menüs und Menüelemente in Versionen vor AIR 2.6 ein displaying-Ereignis abgesetzt, wenn der Benutzer eine Tastenentsprechung gedrückt hat. (Dieses Ereignis wurde bei Interaktionen mit Tastenentsprechungen unter anderen Betriebssystemen nicht abgesetzt.) Seit AIR 2.6 werden keine displaying-Ereignisse mehr abgesetzt, wenn der Benutzer eine Tastenentsprechung drückt. Verwenden Sie stattdessen das preparing-Ereignis.
Event.DISPLAYING-Konstante definiert den Wert der type-Eigenschaft eines displaying-Ereignisobjekts.
Hinweis: Dieses Ereignis durchläuft keine "Erfassungsphase" und wird direkt an das Ziel gesendet – unabhängig davon, ob sich dieses auf der Anzeigeliste befindet.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, das angezeigt werden soll. |
preparing | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.PREPARING| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 2.6 |
Wird vom NativeMenu-Objekt abgesetzt, wenn eine Tastenentsprechung gedrückt wird, und unmittelbar vor dem Einblenden des Menüs.
Verwenden Sie einen Listener für dieses Ereignis, um das Menü zu aktualisieren, bevor es angezeigt wird, oder wenn der Benutzer eine Tastenentsprechung drückt. Das preparing-Ereignis wird abgesetzt, bevor die Tastenentsprechung vollständig evaluiert wurde. Sie können Elemente im preparing-Ereignis-Listener aktivieren, deaktivieren, hinzufügen oder entfernen, und diese Änderungen werden wirksam, wenn die Tastenentsprechung verarbeitet wird. Wenn Sie zum Beispiel das Menüelement, das der auslösenden Tastaturentsprechung zugeordnet ist, entfernen oder deaktivieren, wird die Folge von Ereignissen abgebrochen und es wird kein select-Ereignis abgesetzt. Ein preparing-Ereignis wird auch von den Elementen in einem Menü abgesetzt.
Das preparing-Ereignis ersetzt das displaying-Ereignis und stellt zusätzliche Funktionen bereit. Verwenden Sie einen Listener für das preparing-Ereignis oder für das displaying-Ereignis, aber nicht für beide.
Event.PREPARING-Konstante definiert den Wert der type-Eigenschaft eines preparing-Ereignisobjekts.
Hinweis: Dieses Ereignis durchläuft keine "Erfassungsphase" und wird direkt an das Ziel gesendet – unabhängig davon, ob sich dieses auf der Anzeigeliste befindet.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false |
currentTarget | Das Objekt, das dieses Ereignis abgesetzt hat. |
target | Das Objekt, das dieses Ereignis abgesetzt hat. |
select | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.SELECT| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Wird von diesem NativeMenu-Objekt ausgelöst, wenn eines seiner Menüelemente oder ein Element in einem seiner nachfolgenden Untermenüs ausgewählt wird.
Ein select-Ereignis wird von diesem Menüelement bis zum übergeordneten Menü und weiter durch die Struktur bis zum Stamm-Menüobjekt gesendet (Bubbling). Die target-Eigenschaft des Ereignisobjekts verweist auf das ausgewählte NativeMenuItem-Objekt; die currentTarget-Eigenschaft verweist auf dieses NativeMenu-Objekt.
Event.SELECT-Konstante definiert den Wert der type-Eigenschaft eines select-Ereignisobjekts.
Dieses Ereignis verfügt über die folgenden Eigenschaften:
| Eigenschaft | Wert |
|---|---|
bubbles | false |
cancelable | false. Es gibt kein Standardverhalten, das abgebrochen werden kann. |
currentTarget | Das Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet. |
target | Das Objekt, auf dem ein Objekt ausgewählt wurde. |
Tue Jun 12 2018, 10:04 AM Z