NativeMenuItem

Paket	flash.display
Klasse	public class NativeMenuItem
Vererbung	NativeMenuItem EventDispatcher Object
Unterklassen	ContextMenuItem

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Die NativeMenuItem-Klasse repräsentiert ein einzelnes Element in einem Menü.

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 false für den isSeparator-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 die addSubmenu()-Methode des übergeordneten NativeMenu-Objekts aufrufen, um das Element zu erstellen und gleichzeitig die submenu-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 true für den isSeparator-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

flash.display.NativeMenu
flash.display.NativeMenu.addSubmenu()

Öffentliche Eigenschaften

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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		NativeMenuItem(label:String = "", isSeparator:Boolean = false) 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
		clone():NativeMenuItem Erstellt eine Kopie des NativeMenuItem-Objekts.	NativeMenuItem
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String [override] Gibt einen String zurück, der alle Eigenschaften des NativeMenuItem-Objekts enthält.	NativeMenuItem
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Übersicht	Definiert von
activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher
displaying	Wird von diesem NativeMenuItem-Objekt ausgelöst, unmittelbar bevor das Menü, das das Element enthält, angezeigt wird.	NativeMenuItem
preparing	Wird von diesem NativeMenuItem-Objekt abgesetzt, wenn die Tastenentsprechung gedrückt wird, und kurz bevor das entsprechende Menü eingeblendet wird.	NativeMenuItem
select	Wird immer ausgelöst, wenn der Benutzer ein Menüelement auswählt.	NativeMenuItem

Eigenschaftendetails

checked

Eigenschaft

checked:Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Steuert, ob für dieses Menüelement ein Häkchen angezeigt wird.

Implementierung
public function get checked():Boolean
public function set checked(value:Boolean):void

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

enabled:Boolean

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Steuert, ob dieses Menüelement aktiviert ist.

Implementierung
public function get enabled():Boolean
public function set enabled(value:Boolean):void

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.ALTERNATE
Keyboard.COMMAND
Keyboard.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):void

Verwandte API-Elemente

flash.ui.Keyboard

label

Eigenschaft

label:String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Der Anzeigestring dieses Menüelements.

Implementierung
public function get label():String
public function set label(value:String):void

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):void

Verwandte API-Elemente

flash.display.NativeMenu.addSubmenu()

Konstruktordetails

()

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().

Parameter

	`label:String` (default = "") — Die anzuzeigende Bezeichnung für das Element oder ein leerer String für Trennlinien.

	`isSeparator:Boolean` (default = `false`) — `true`, um eine Trennlinie zu erstellen, andernfalls `false`.

Verwandte API-Elemente

flash.display.NativeMenu.addSubmenu()

Methodendetails

clone

()

Methode

public function clone():NativeMenuItem

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Erstellt eine Kopie des NativeMenuItem-Objekts.

Rückgabewerte

NativeMenuItem

toString

()

Methode

override public function toString():String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0

Gibt einen String zurück, der alle Eigenschaften des NativeMenuItem-Objekts enthält.

Rückgabewerte

String — Eine Zeichenfolge, die alle Eigenschaften des Ereignisobjekts enthält.

Ereignisdetails

displaying

Ereignis

Ereignisobjekttyp: flash.events.Event
Eigenschaft 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.

Die 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

Ereignisobjekttyp: flash.events.Event
Eigenschaft 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.

Die 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

Ereignisobjekttyp: flash.events.Event
Eigenschaft 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.

Die 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.

Rechtliche Hinweise | Onlinedatenschutzerklärung

NativeMenuItem - AS3

Paketex

Sprachelemente

Anhänge

Paket flash.display

checked

data

enabled

isSeparator

keyEquivalent

keyEquivalentModifiers

label

menu

mnemonicIndex

name

submenu

NativeMenuItem

clone

toString

displaying

preparing

select