Pacoteflash.display
Classepublic class NativeMenuItem
HerançaNativeMenuItem Inheritance EventDispatcher Inheritance Object
Subclasses ContextMenuItem

The NativeMenuItem class represents a single item in a menu.

A menu item can be a command, a submenu, or a separator line:

Listen for select events on an item or a parent menu to detect when a menu command is selected. Neither submenus nor separators dispatch select events. Listen for displaying events to determine when a menu item about to be displayed.

Veja também

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


Propriedades Públicas
 PropriedadeDefinido por
  checked : Boolean
Controls whether this menu item displays a checkmark.
NativeMenuItem
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
  data : Object
An arbitrary data object associated with this menu item.
NativeMenuItem
  enabled : Boolean
Controls whether this menu item is enabled.
NativeMenuItem
  isSeparator : Boolean
[read-only] Reports whether this item is a menu separator line.
NativeMenuItem
  keyEquivalent : String
The key equivalent for this menu item.
NativeMenuItem
  keyEquivalentModifiers : Array
The array of key codes for the key equivalent modifiers.
NativeMenuItem
  label : String
The display string of this menu item.
NativeMenuItem
  menu : NativeMenu
[read-only] The menu that contains this item.
NativeMenuItem
  mnemonicIndex : int
The position of the mnemonic character in the menu item label.
NativeMenuItem
  name : String
The name of this menu item.
NativeMenuItem
 Inheritedprototype : Object
[static] A reference to the prototype object of a class or function object.
Object
  submenu : NativeMenu
The submenu associated with this menu item.
NativeMenuItem
Métodos Públicos
 MétodoDefinido por
  
NativeMenuItem(label:String = "", isSeparator:Boolean = false)
Creates a new NativeMenuItem.
NativeMenuItem
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
EventDispatcher
  
Creates a copy of the menuitem and all items.
NativeMenuItem
 Inherited
Dispatches an event into the event flow.
EventDispatcher
  
formatToString(className:String, ... arguments):String
NativeMenuItem
 Inherited
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
EventDispatcher
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
  
Selects a menu item based on key equivalent
NativeMenuItem
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
EventDispatcher
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
  
Returns a string containing all the properties of the NativeMenuItem object.
NativeMenuItem
 Inherited
Returns the primitive value of the specified object.
Object
 Inherited
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
EventDispatcher
Eventos
 Evento Descrição Definido por
 Inherited Dispatched when Flash Player or the and AIR application gains operating system focus and becomes active.EventDispatcher
 Inherited Dispatched when Flash Player loses operating system focus and is becoming inactive.EventDispatcher
   Dispatched by this NativeMenuItem object immediately before the menu containing the item is displayed.NativeMenuItem
   Dispatched whenever a menu item is selected by the user.NativeMenuItem
Detalhes da propriedade
checkedpropriedade
checked:Boolean  [read-write]

Controls whether this menu item displays a checkmark.


Implementação
    public function get checked():Boolean
    public function set checked(value:Boolean):void
datapropriedade 
data:Object  [read-write]

An arbitrary data object associated with this menu item.

You can assign any object to this property. The assigned object is not used by the menu system, but is available to event handling code. By default, the value of this property is null.


Implementação
    public function get data():Object
    public function set data(value:Object):void
enabledpropriedade 
enabled:Boolean  [read-write]

Controls whether this menu item is enabled.


Implementação
    public function get enabled():Boolean
    public function set enabled(value:Boolean):void
isSeparatorpropriedade 
isSeparator:Boolean  [read-only]

Reports whether this item is a menu separator line.

Create a separator line by setting the isSeparator parameter in the NativeMenuItem constructor to true.


Implementação
    public function get isSeparator():Boolean
keyEquivalentpropriedade 
keyEquivalent:String  [read-write]

The key equivalent for this menu item.


Implementação
    public function get keyEquivalent():String
    public function set keyEquivalent(value:String):void
keyEquivalentModifierspropriedade 
keyEquivalentModifiers:Array  [read-write]

The array of key codes for the key equivalent modifiers.

Use the constants defined in the Keyboard class to specify the modifier key codes. Valid modifer keys include:


Implementação
    public function get keyEquivalentModifiers():Array
    public function set keyEquivalentModifiers(value:Array):void
labelpropriedade 
label:String  [read-write]

The display string of this menu item.


Implementação
    public function get label():String
    public function set label(value:String):void
menupropriedade 
menu:NativeMenu  [read-only]

The menu that contains this item.


Implementação
    public function get menu():NativeMenu
mnemonicIndexpropriedade 
mnemonicIndex:int  [read-write]

The position of the mnemonic character in the menu item label.

The character at the specified position will become the mnemonic character for the menu item. The index is zero-based, so the first character has an index of 0.

This property is ignored on operating systems that do not use menu mnemonics.


Implementação
    public function get mnemonicIndex():int
    public function set mnemonicIndex(value:int):void
namepropriedade 
name:String  [read-write]

The name of this menu item.

The name value is not displayed and can be used as a locale-independent identifier.


Implementação
    public function get name():String
    public function set name(value:String):void
submenupropriedade 
submenu:NativeMenu  [read-write]

The submenu associated with this menu item.

Assigning a NativeMenu object to this property will change the appearance and behavior of the menu item. A submenu item will display the submenu icon and will no longer dispatch select events.


Implementação
    public function get submenu():NativeMenu
    public function set submenu(value:NativeMenu):void

Veja também

Detalhes do construtor
NativeMenuItem()Construtor
public function NativeMenuItem(label:String = "", isSeparator:Boolean = false)

Creates a new NativeMenuItem.

To create a menu command, set the label parameter to a string containing the display label and set isSeparator to false.

To create a submenu command, create a command item, then assign the NativeMenu object or the submenu to the item's submenu property. Add the item to the parent menu.

To create a separator, set the label parameter to an empty string and set isSeparator to true.

Add and remove items from a menu using the NativeMenu addItem() and removeItem() methods.

Parâmetros
label:String (default = "") — The display label for the item, or an empty string for separators.
 
isSeparator:Boolean (default = false) — Set to true to create a separator; set to false otherwise.

Veja também

Detalhes do método
clone()método
public function clone():NativeMenuItem

Creates a copy of the menuitem and all items.

Retorna
NativeMenuItem
formatToString()método 
public function formatToString(className:String, ... arguments):String

Parâmetros

className:String
 
... arguments

Retorna
String
performKeyEquivalent()método 
public function performKeyEquivalent(event:KeyboardEvent):Boolean

Selects a menu item based on key equivalent

Parâmetros

event:KeyboardEvent — The keyboard event to test against

Retorna
Boolean
toString()método 
public override function toString():String

Returns a string containing all the properties of the NativeMenuItem object.

Retorna
String — A string containing all the properties of the Event object.
Detalhes do evento
displaying Evento
Event Object Type: flash.events.Event
Event.type property = flash.events.Event.DISPLAYING

Dispatched by this NativeMenuItem object immediately before the menu containing the item is displayed.

The target property of the event object will reference the NativeMenu containing this NativeMenuItem object; the currentTarget property will reference this NativeMenuItem.

Defines the value of the type property of a displaying event object.

Note: This event does not go through a "capture phase" and is dispatched directly to the target, whether the target is on the display list or not.

This event has the following properties:

PropriedadeValor
bubblesfalse
cancelablefalse
currentTargetThe object that is actively processing the Event object with an event listener.
targetThe object that is about to be displayed.
select Evento  
Event Object Type: flash.events.Event
Event.type property = flash.events.Event.SELECT

Dispatched whenever a menu item is selected by the user.

A select event will "bubble" from this item to its containing menu and on up through the parent menu chain to the root menu object. The target property of the event object will reference this NativeMenuItem object; the currentTarget property will reference the dispatching object (either this NativeMenuItem or an ancestral NativeMenu object).

The Event.SELECT constant defines the value of the type property of a select event object.

This event has the following properties:

PropriedadeValor
bubblesfalse
cancelablefalse; there is no default behavior to cancel.
currentTargetThe object that is actively processing the Event object with an event listener.
targetThe object on which an item has been selected.