ActionScript® 3.0 Referenzhandbuch für die Adobe® Flash®-Plattform
Home  |  Liste der Pakete und Klassen ausblenden |  Pakete  |  Klassen  |  Neue Funktionen  |  Stichwortverzeichnis  |  Anhänge  |  Warum auf Englisch?
Filter: AIR 30.0 und früher, Flash Player 30.0 und früher, Flash Lite 4
Flex 4.6 und früher, Flash Pro CS6 und früher
Filter ausblenden
flash.display 

NativeMenuItem  - AS3

Paketflash.display
Klassepublic class NativeMenuItem
VererbungNativeMenuItem Inheritance EventDispatcher Inheritance 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
 EigenschaftDefiniert von
      checked : Boolean
Steuert, ob für dieses Menüelement ein Häkchen angezeigt wird.
NativeMenuItem
 Inheritedconstructor : 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
 MethodeDefiniert von
  
    NativeMenuItem(label:String = "", isSeparator:Boolean = false)
Erstellt ein neues NativeMenuItem-Objekt.
NativeMenuItem
 Inherited
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
 Inherited
dispatchEvent(event:Event):Boolean
Sendet ein Ereignis in den Ereignisablauf.
EventDispatcher
 Inherited
hasEventListener(type:String):Boolean
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.
Object
 Inherited
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
 Inherited
propertyIsEnumerable(name:String):Boolean
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Entfernt einen Listener aus dem EventDispatcher-Objekt.
EventDispatcher
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.
Object
 Inherited
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
 Inherited
valueOf():Object
Gibt den Grundwert des angegebenen Objekts zurück.
Object
 Inherited
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.
 Ereignis Übersicht Definiert von
 Inherited
activate
[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.EventDispatcher
 Inherited
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
    

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

Verwandte API-Elemente

flash.display.NativeMenu.addSubmenu()
Konstruktordetails
    

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

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:

EigenschaftWert
bubblesfalse
cancelablefalse
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas 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.

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

EigenschaftWert
bubblesfalse
cancelablefalse
currentTargetDas Objekt, das dieses Ereignis abgesetzt hat.
targetDas 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:

EigenschaftWert
bubblesfalse
cancelablefalse. Es gibt kein Standardverhalten, das abgebrochen werden kann.
currentTargetDas Objekt, welches das Ereignisobjekt aktiv mit einem Ereignis-Listener verarbeitet.
targetDas Objekt, auf dem ein Objekt ausgewählt wurde.



© 2015 Adobe Systems Incorporated. All rights reserved.
Tue Jun 12 2018, 10:04 AM Z
 

 

Rechtliche Hinweise | Onlinedatenschutzerklärung
[ X ]Warum auf Englisch?
Inhalt des ActionScript 3.0-Referenzhandbuchs wird in englischer Sprache angezeigt

Nicht alle Teile des ActionScript 3.0-Referenzhandbuchs wurden in alle Sprachen übersetzt. Wenn der Text zu einem Sprachelement nicht übersetzt wurde, wird er auf Englisch angezeigt. Zum Beispiel wurden die Informationen zur ga.controls.HelpBox-Klasse nicht in andere Sprachen übersetzt. In der deutschen Version des Referenzhandbuchs erscheint der Abschnitt zur ga.controls.HelpBox-Klasse deshalb auf Englisch.