| Paket | flash.display |
| Klasse | public class NativeMenuItem |
| Vererbung | NativeMenuItem  EventDispatcher Object |
| Unterklassen | ContextMenuItem |
| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Bei einem Menüelement kann es sich um einen Befehl, ein Untermenü oder um eine Trennlinie handeln:
- Zum Erstellen eines Befehls rufen Sie den NativeMenuItem-Konstruktor auf und übergeben dabei einen String für die Bezeichnung sowie den Wert
falsefür denisSeparator-Parameter. - Zum Erstellen eines Untermenüs erstellen Sie einen Befehl für das übergeordnete Menü und weisen das NativeMenu-Objekt des Untermenüs der
submenu-Eigenschaft des Befehls zu. Sie können auch dieaddSubmenu()-Methode des übergeordneten NativeMenu-Objekts aufrufen, um das Element zu erstellen und gleichzeitig diesubmenu-Eigenschaft zu setzen. - Zum Erstellen einer Trennlinie rufen Sie den NativeMenuItem-Konstruktor auf und übergeben dabei einen leeren String für die Bezeichnung sowie den Wert
truefür denisSeparator-Parameter.
Durch Warten auf select-Ereignisse für einen Befehl oder ein übergeordnetes Menü kann festgestellt werden, wann ein Menübefehl ausgewählt wird. Untermenüs und Trennlinien lösen keine select-Ereignisse aus. Verwenden Sie einen Listener für preparing-Ereignisse, um festzustellen, ob in Kürze ein Menüeintrag angezeigt oder durch eine Tastenentsprechung aktiviert wird.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
| checked : Boolean
Steuert, ob für dieses Menüelement ein Häkchen angezeigt wird. | NativeMenuItem | ||
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| data : Object
Ein beliebiges Datenobjekt, das zu diesem Menüelement gehört. | NativeMenuItem | ||
| enabled : Boolean
Steuert, ob dieses Menüelement aktiviert ist. | NativeMenuItem | ||
| isSeparator : Boolean [schreibgeschützt]
Gibt an, ob es sich bei diesem Element um eine Menütrennlinie handelt. | NativeMenuItem | ||
| keyEquivalent : String
Der Tastaturbefehl für dieses Menüelement. | NativeMenuItem | ||
| keyEquivalentModifiers : Array
Das Tastencode-Array für die Zusatztasten des Tastaturbefehls. | NativeMenuItem | ||
| label : String
Der Anzeigestring dieses Menüelements. | NativeMenuItem | ||
| menu : NativeMenu [schreibgeschützt]
Das Menü, das dieses Element enthält. | NativeMenuItem | ||
| mnemonicIndex : int
Die Position des Zugriffszeichens in der Bezeichnung des Menüelements. | NativeMenuItem | ||
| name : String
Der Name dieses Menüelements. | NativeMenuItem | ||
| submenu : NativeMenu
Das Untermenü, das zu diesem Menüelement gehört. | NativeMenuItem | ||
| Methode | Definiert von | ||
|---|---|---|---|
Erstellt ein neues NativeMenuItem-Objekt. | NativeMenuItem | ||
| 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 | |
Erstellt eine Kopie des NativeMenuItem-Objekts. | NativeMenuItem | ||
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Ü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 einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
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 | |
[override]
Gibt einen String zurück, der alle Eigenschaften des NativeMenuItem-Objekts enthält. | NativeMenuItem | ||
|
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 von diesem NativeMenuItem-Objekt ausgelöst, unmittelbar bevor das Menü, das das Element enthält, angezeigt wird. | NativeMenuItem | |||
| Wird von diesem NativeMenuItem-Objekt abgesetzt, wenn die Tastenentsprechung gedrückt wird, und kurz bevor das entsprechende Menü eingeblendet wird. | NativeMenuItem | |||
| Wird immer ausgelöst, wenn der Benutzer ein Menüelement auswählt. | NativeMenuItem | |||
checked | Eigenschaft |
data | Eigenschaft |
data:Object| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Ein beliebiges Datenobjekt, das zu diesem Menüelement gehört.
Sie können dieser Eigenschaft jedes Objekt zuweisen. Das zugewiesene Objekt wird nicht vom Menüsystm verwendet, sondern steht für Ereignisprozedurcode zur Verfügung (über die target-Eigenschaft des Ereignisobjekts). Standardmäßig hat diese Eigenschaft den Wert null.
Implementierung
public function get data():Object public function set data(value:Object):void enabled | Eigenschaft |
isSeparator | Eigenschaft |
isSeparator:Boolean [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Gibt an, ob es sich bei diesem Element um eine Menütrennlinie handelt.
Zum Erstellen einer Trennlinie stellen Sie den isSeparator-Parameter im NativeMenuItem-Konstruktor auf true ein.
Implementierung
public function get isSeparator():Boolean keyEquivalent | Eigenschaft |
keyEquivalent:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Der Tastaturbefehl für dieses Menüelement.
Setzen Sie keyEquivalent mit einem Kleinbuchstaben, um einen Kurzbefehl, der keine Betätigung der Umschalttaste erfordert, zuzuweisen. Setzen Sie einen Großbuchstaben, um einen Kurzbefehl, der die Betätigung der Umschalttaste erfordert, zuzuweisen.
Standardmäßig erfordern Tastaturbefehle die Betätigung einer Zusatztaste (die Strg-Taste unter Windows und die Befehlstaste unter Mac OS X). Wenn Sie einen Tastaturbefehl ohne Zusatztaste festlegen möchten, setzen Sie die keyEquivalentModifiers-Eigenschaft auf ein leeres Array.
Implementierung
public function get keyEquivalent():String public function set keyEquivalent(value:String):void keyEquivalentModifiers | Eigenschaft |
keyEquivalentModifiers:Array| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das Tastencode-Array für die Zusatztasten des Tastaturbefehls.
Verwenden Sie die in der Keyboard-Klasse definierten Konstanten, um die Zusatztastencodes anzugeben. Gültige Zusatztasten sind:
Keyboard.ALTERNATEKeyboard.COMMANDKeyboard.CONTROL
Wenn Sie keine Zusatztaste zuweisen, wird unter Windows oder Linux standardmäßig die Keyboard.CONTROL-Taste zugewiesen, unter Mac OS X die Keyboard.COMMAND-Taste. Wenn Sie diese Zusatztasten nicht verwenden möchten, setzen Sie diese Eigenschaft auf ein leeres Array.
Wenn Sie der keyEquivalent-Eigenschaft einen Großbuchstaben zuweisen, wird automatisch die Umschalttaste als Zusatztaste verwendet. Wenn Sie keyEquivalentModifier auf ein leeres Array setzen, wird die Umschalttaste als Zusatztaste nicht entfernt.
Implementierung
public function get keyEquivalentModifiers():Array public function set keyEquivalentModifiers(value:Array):voidVerwandte API-Elemente
label | Eigenschaft |
menu | Eigenschaft |
menu:NativeMenu [schreibgeschützt] | Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das Menü, das dieses Element enthält.
Implementierung
public function get menu():NativeMenu mnemonicIndex | Eigenschaft |
mnemonicIndex:int| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Die Position des Zugriffszeichens in der Bezeichnung des Menüelements.
Das Zeichen an der angegebenen Position ist das Zugriffszeichen des Menüelements. Der Index basiert auf Null, das heißt, dass das erste Zeichen den Indexwert 0 hat.
Auf Betriebssystemen, die keine Zugriffszeichen für Menüs verwenden, wird diese Eigenschaft ignoriert.
Implementierung
public function get mnemonicIndex():int public function set mnemonicIndex(value:int):void name | Eigenschaft |
name:String| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Der Name dieses Menüelements.
Der Namenswert wird nicht angezeigt und kann als vom Gebietsschema unabhängiger Bezeichner verwendet werden. Die Zuweisung von Namen erfolgt nicht automatisch.
Implementierung
public function get name():String public function set name(value:String):void submenu | Eigenschaft |
submenu:NativeMenu| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Das Untermenü, das zu diesem Menüelement gehört.
Wenn dieser Eigenschaft ein NativeMenu-Objekt zugewiesen wird, ändern sich Darstellung und Verhalten des Menüelements. Ein Untermenüelement zeigt das Untermenüsymbol an und löst keine select-Ereignisse mehr aus.
Hinweis: Wird ein Menü sich selbst als Untermenü hinzugefügt (Zirkelverweis), kann die Anwendung hängen bleiben.
Implementierung
public function get submenu():NativeMenu public function set submenu(value:NativeMenu):voidVerwandte API-Elemente
NativeMenuItem | () | Konstruktor |
public function NativeMenuItem(label:String = "", isSeparator:Boolean = false)| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Erstellt ein neues NativeMenuItem-Objekt.
Zum Erstellen eines Menübefehls stellen Sie den label-Parameter auf einen String ein, der die anzuzeigende Bezeichnung enthält, und setzen Sie isSeparator auf false.
Zum Erstellen eines Untermenübefehls erstellen Sie ein Befehlselement und weisen dann das NativeMenu-Objekt des Untermenüs der submenu-Eigenschaft des Elements zu. Fügen Sie das Element dem übergeordneten Menü hinzu.
Zum Erstellen einer Trennlinie stellen Sie den label-Parameter auf einen leeren String ein und setzen Sie isSeparator auf true.
Um Elemente in einem Menü hinzuzufügen oder zu entfernen, verwenden Sie die NativeMenu-Methoden addItem() und removeItem().
label:String (default = " | |
isSeparator:Boolean (default = false)true, um eine Trennlinie zu erstellen, andernfalls false.
|
Verwandte API-Elemente
clone | () | Methode |
public function clone():NativeMenuItem| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Erstellt eine Kopie des NativeMenuItem-Objekts.
RückgabewerteNativeMenuItem |
toString | () | Methode |
displaying | Ereignis |
flash.events.EventEigenschaft Event.type =
flash.events.Event.DISPLAYING| Sprachversion: | ActionScript 3.0 |
| Laufzeitversionen: | AIR 1.0 |
Wird von diesem NativeMenuItem-Objekt ausgelöst, unmittelbar bevor das Menü, das das Element enthält, angezeigt wird.
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.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 von diesem NativeMenuItem-Objekt abgesetzt, wenn die Tastenentsprechung gedrückt wird, und kurz bevor das entsprechende Menü eingeblendet wird.
Verwenden Sie einen Listener für dieses Ereignis, um das Element zu aktualisieren, bevor das enthaltende Menü angezeigt wird, oder wenn der Benutzer die Tastenentsprechung drückt. Das preparing-Ereignis wird abgesetzt, bevor die Tastenentsprechung vollständig evaluiert wurde. Sie können das Element im preparing-Ereignis-Listener aktivieren, deaktivieren oder entfernen, und diese Änderungen werden wirksam, wenn die Tastenentsprechung verarbeitet wird. Wenn Sie diesen Menüeintrag zum Beispiel entfernen oder deaktivieren, wird die Folge von Ereignissen abgebrochen und es wird kein select-Ereignis abgesetzt. Ein preparing-Ereignis wird auch von den anderen 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 immer ausgelöst, wenn der Benutzer ein Menüelement auswählt.
Ein select-Ereignis wird von diesem Element bis zum übergeordneten Menü und weiter durch die Struktur bis zum Stamm-Menüobjekt gesendet (Bubbling). Die target-Eigenschaft des Ereignisobjekts verweist auf dieses NativeMenuItem-Objekt. Die currentTarget-Eigenschaft verweist auf das auslösende Objekt (entweder dieses NativeMenuItem-Objekt oder ein übergeordnetes NativeMenu-Objekt).
Hinweis: Wenn sich das Menü in einem Fenster im Vollbildmodus befindet (stage.displayState == StageDisplayState.FULL_SCREEN), löst das NativeMenuItem-Objekt kein select-Ereignis aus, wenn der Benutzer einen Tastaturbefehl für ein Menüelement eingibt.
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