NativeMenuItem

Paquete	flash.display
Clase	public class NativeMenuItem
Herencia	NativeMenuItem EventDispatcher Object
Subclases	ContextMenuItem

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

La clase NativeMenuItem representa un único elemento de menú.

Un elemento de menú puede ser un comando, un submenú o una línea de separador:

Para crear un comando, llame al constructor NativeMenuItem y transfiera una cadena para la etiqueta y el valor false para el parámetro isSeparator.
Para crear un submenú, cree un comando para el menú principal y luego asigne el objeto NativeMenu del submenú a la propiedad submenu del elemento. También puede llamar al método addSubmenu() del objeto NativeMenu principal para crear el elemento y establecer la propiedad submenu al mismo tiempo.
Para crear un separador, llame al constructor NativeMenuItem y transfiera una cadena vacía para la etiqueta y el valor true para el parámetro isSeparator.

Detecte eventos select en un menú o elemento principal para saber cuándo se selecciona un comando del menú. Ni los submenús ni los separadores pueden distribuir eventos select. Detecte eventos preparing para determinar cuándo se va a mostrar un elemento de menú o si se va a activar a través de un equivalente de tecla.

Elementos de API relacionados

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

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		checked : Boolean Controla si el elemento de menú muestra una marca de verificación.	NativeMenuItem
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		data : Object Datos arbitrarios asociados al elemento de menú.	NativeMenuItem
		enabled : Boolean Controla si el elemento de menú está activado.	NativeMenuItem
		isSeparator : Boolean [solo lectura] Indica si el elemento es una línea de separador.	NativeMenuItem
		keyEquivalent : String Equivalente de teclado del elemento de menú.	NativeMenuItem
		keyEquivalentModifiers : Array Conjunto de códigos de tecla de los modificadores de equivalentes de teclado.	NativeMenuItem
		label : String Cadena de visualización del elemento de menú.	NativeMenuItem
		menu : NativeMenu [solo lectura] Menú que contiene el elemento.	NativeMenuItem
		mnemonicIndex : int Posición del carácter mnemónico de la etiqueta del elemento de menú.	NativeMenuItem
		name : String Nombre del elemento de menú.	NativeMenuItem
		submenu : NativeMenu Submenú asociado al elemento de menú.	NativeMenuItem

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		NativeMenuItem(label:String = "", isSeparator:Boolean = false) Crea un objeto NativeMenuItem.	NativeMenuItem
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento.	EventDispatcher
		clone():NativeMenuItem Crea una copia del objeto NativeMenuItem.	NativeMenuItem
		dispatchEvent(event:Event):Boolean Distribuye un evento en el flujo del evento.	EventDispatcher
		hasEventListener(type:String):Boolean Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Elimina un detector del objeto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String [override] Devuelve una cadena que contiene todas las propiedades del objeto NativeMenuItem.	NativeMenuItem
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object
		willTrigger(type:String):Boolean Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto.	EventDispatcher

Eventos

Haga clic para obtener más información sobre los eventos

Ocultar eventos heredados

Mostrar eventos heredados

	Resumen	Definido por
activate	[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos.	EventDispatcher
deactivate	[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos.	EventDispatcher
displaying	Distribuido por el objeto NativeMenuItem inmediatamente antes de que se muestre el menú que contiene el elemento.	NativeMenuItem
preparing	Distribuido por este objeto NativeMenuItem cuando su equivalente de tecla se presiona e inmediatamente antes de que aparezca el menú.	NativeMenuItem
select	Se distribuye cada vez que el usuario selecciona un elemento de menú.	NativeMenuItem

Información sobre propiedades

checked

propiedad

checked:Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Controla si el elemento de menú muestra una marca de verificación.

Implementación
public function get checked():Boolean
public function set checked(value:Boolean):void

data

propiedad

data:Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Datos arbitrarios asociados al elemento de menú.

Puede asignar cualquier objeto a esta propiedad. El sistema de menús no utiliza el objeto asignado, pero está disponible para el código de control de eventos (mediante la propiedad target del objeto de evento). De manera predeterminada, el valor de esta propiedad es null.

Implementación
public function get data():Object
public function set data(value:Object):void

enabled

propiedad

enabled:Boolean

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Controla si el elemento de menú está activado.

Implementación
public function get enabled():Boolean
public function set enabled(value:Boolean):void

isSeparator

propiedad

isSeparator:Boolean [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Indica si el elemento es una línea de separador.

Para crear una línea de separador, establezca el parámetro isSeparator del constructor NativeMenuItem como true.

Implementación
public function get isSeparator():Boolean

keyEquivalent

propiedad

keyEquivalent:String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Equivalente de teclado del elemento de menú.

Establezca keyEquivalent con una letra en minúscula para asignar un acceso directo sin necesidad de la tecla modificadora Mayús. Establézcalo con una letra en minúscula para asignar un acceso directo con la tecla modificadora Mayús.

De forma predeterminada, se incluye un modificador de equivalentes de teclado (Ctrl en Windows y Comando en Mac OS X o en Linux) como parte del equivalente de teclado. Si quiere que un equivalente de teclado sea una tecla sin modificador, establezca la propiedad keyEquivalentModifiers como un conjunto vacío.

Implementación
public function get keyEquivalent():String
public function set keyEquivalent(value:String):void

keyEquivalentModifiers

propiedad

keyEquivalentModifiers:Array

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Conjunto de códigos de tecla de los modificadores de equivalentes de teclado.

Utilice las constantes definidas en la clase Keyboard para especificar los códigos de teclas de modificación. Las teclas de modificación válidas son:

Keyboard.ALTERNATE
Keyboard.COMMAND
Keyboard.CONTROL

Si no asigna ningún modificador, de forma predeterminada se asigna la clave Keyboard.CONTROL en Windows o en Linux y la clave Keyboard.COMMAND en Mac OS X. Si no quiere que la clave equivalente incluya estos modificadores, establezca esta propiedad como un conjunto vacío.

Si asigna una letra en minúscula a la propiedad keyEquivalent, la tecla Mayús se utiliza como modificador automáticamente. Si establece keyEquivalentModifier como un conjunto vacío, la tecla Mayús no se elimina como modificador.

Implementación
public function get keyEquivalentModifiers():Array
public function set keyEquivalentModifiers(value:Array):void

Elementos de API relacionados

flash.ui.Keyboard

label

propiedad

label:String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Cadena de visualización del elemento de menú.

Implementación
public function get label():String
public function set label(value:String):void

mnemonicIndex

propiedad

mnemonicIndex:int

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Posición del carácter mnemónico de la etiqueta del elemento de menú.

El carácter de la posición especificada pasa a ser el carácter mnemónico del elemento de menú. El índice está basado en ceros, por lo que el índice del primer carácter es 0.

Esta propiedad se omite en sistemas operativos que no utilicen caracteres mnemónicos.

Implementación
public function get mnemonicIndex():int
public function set mnemonicIndex(value:int):void

name

propiedad

name:String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Nombre del elemento de menú.

El valor del nombre no se muestra y se puede utilizar como identificador independiente de configuración regional. El nombre no se asigna automáticamente.

Implementación
public function get name():String
public function set name(value:String):void

submenu

propiedad

submenu:NativeMenu

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Submenú asociado al elemento de menú.

Al asignar un objeto NativeMenu a esta propiedad, cambia el aspecto y el comportamiento del elemento de menú. Un elemento de submenú muestra el icono del submenú y deja de distribuir eventos select.

Nota: añadir un menú como un submenú de sí mismo (en una referencia circular) puede provocar que la aplicación se bloquee.

Implementación
public function get submenu():NativeMenu
public function set submenu(value:NativeMenu):void

Elementos de API relacionados

flash.display.NativeMenu.addSubmenu()

Información sobre constructores

()

Información sobre

public function NativeMenuItem(label:String = "", isSeparator:Boolean = false)

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Crea un objeto NativeMenuItem.

Para crear un comando de menú, establezca el parámetro label como una cadena que contenga la etiqueta de visualización y defina isSeparator como false.

Para crear un comando de submenú, cree primero un comando, luego asigne el objeto NativeMenu o el submenú a la propiedad submenu del elemento . Añade el elemento al menú principal.

Para crear un separador, establezca el parámetro label como una cadena vacía y defina isSeparator como true.

Añade y elimina elementos de un menú con los métodos addItem() y removeItem() de NativeMenu.

Parámetros

	`label:String` (default = "") — Etiqueta de visualización del elemento, o cadena vacía si se trata de un separador.

	`isSeparator:Boolean` (default = `false`) — Establezca su valor en `true` para crear un separador; en caso contrario, configúrelo en `false`.

Elementos de API relacionados

flash.display.NativeMenu.addSubmenu()

Información sobre métodos

clone

()

método

public function clone():NativeMenuItem

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Crea una copia del objeto NativeMenuItem.

Valor devuelto

NativeMenuItem

toString

()

método

override public function toString():String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Devuelve una cadena que contiene todas las propiedades del objeto NativeMenuItem.

Valor devuelto

String — Una cadena que contiene todas las propiedades del objeto de evento.

Información sobre eventos

displaying

Evento

Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.DISPLAYING

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Distribuido por el objeto NativeMenuItem inmediatamente antes de que se muestre el menú que contiene el elemento.

El evento preparing tiene prioridad sobre el evento mostrar y proporciona una funcionalidad adicional. Detecte el evento preparing o el evento display, pero no ambos.

La constante Event.DISPLAYING define el valor de la propiedad type de un objeto de evento displaying.

Nota: este evento no recorre una "fase de captura" y se distribuye directamente en el destino, ya se encuentre este destino en la lista de visualización o no.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto que se va a mostrar.

preparing

Evento

Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.PREPARING

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 2.6

Distribuido por este objeto NativeMenuItem cuando su equivalente de tecla se presiona e inmediatamente antes de que aparezca el menú.

Detecte este evento para actualizar el elemento antes de que aparezca el menú que contiene, o cuando el usuario presiona su equivalente de teclas. El evento preparing se distribuye antes de que se calcule totalmente el equivalente de teclas. Puede activar, desactivar o quitar el elemento del menú con el controlador de eventos a preparing; dichos cambios tendrán efecto cuando se procese el equivalente de teclas. Por ejemplo, si se elimina o desactiva este elemento de menú, entonces la secuencia de eventos se cancela y se distribuye un evento select. También se distribuye un evento preparing por los otros elementos del menú.

El evento preparing tiene prioridad sobre el evento mostrar y proporciona una funcionalidad adicional. Detecte el evento preparing o el evento display, pero no ambos.

La constante Event.PREPARING define el valor de la propiedad type de un objeto de evento preparing.

Nota: este evento no recorre una "fase de captura" y se distribuye directamente en el destino, ya se encuentre este destino en la lista de visualización o no.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	El objeto que inició este evento.
`target`	El objeto que inició este evento.

select

Evento

Tipo de objeto de evento: flash.events.Event
propiedad Event.type = flash.events.Event.SELECT

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

AIR 1.0

Se distribuye cada vez que el usuario selecciona un elemento de menú.

Un evento select emite una acción bubble (propagación) desde el elemento hasta el menú que lo contiene hasta llevar al menú principal vinculado al objeto raíz del menú. La propiedad target del objeto del evento hace referencia a este objeto NativeMenuItem; la propiedad currentTarget hacer referencia al objeto distribuido (este objeto NativeMenuItem u otro objeto NativeMenu anterior).

Nota: si la ventana que contiene el menú está en modo de pantalla completa (stage.displayState == StageDisplayState.FULL_SCREEN), el objeto NativeMenuItem no distribuye un evento select cuando el usuario teclea una método abreviado para acceder a un elemento de menú.

La constante Event.SELECT define el valor de la propiedad type de un objeto de evento select.

Este evento tiene las propiedades siguientes:

Propiedad	Valor
`bubbles`	`false`
`cancelable`	`false`; no hay ningún comportamiento predeterminado que cancelar.
`currentTarget`	Objeto que procesa de forma activa el objeto de evento con un detector de eventos.
`target`	El objeto en el que se ha seleccionado un elemento.

Avisos legales | Política de privacidad en línea

NativeMenuItem - AS3

Paquetesx

Elementos del lenguaje

Apéndices

Paquete flash.display

checked

data

enabled

isSeparator

keyEquivalent

keyEquivalentModifiers

label

menu

mnemonicIndex

name

submenu

NativeMenuItem

clone

toString

displaying

preparing

select