NativeMenuItem

Pacote	flash.display
Classe	public class NativeMenuItem
Herança	NativeMenuItem EventDispatcher Object
Subclasses	ContextMenuItem

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

A classe NativeMenuItem representa um único item no menu.

O item de menu pode ser um comando, um submenu ou uma linha separadora:

Para criar um item de comando, chame o construtor NativeMenuItem passando em uma string para o rótulo e false para o parâmetro isSeparator.
Para criar um submenu, crie um item de comando para o menu pai e atribua o objeto NativeMenu do submenu à propriedade de submenu do item. Você também pode chamar o método addSubmenu() do objeto NativeMenu nativo para criar o item e definir a propriedade submenu ao mesmo tempo.
Para criar um separador, chame o construtor NativeMenuItem passando em uma string vazia para o rótulo e true para o parâmetro isSeparator.

Monitore os eventos select em um item ou em um menu pai para detectar quando se seleciona um comando de menu. Os submenus e separadores não despacham eventos select. Escute os eventos preparing para determinar quando um item de menu está a ponto de ser exibido ou ativado por um equivalente de tecla.

Elementos da API relacionados

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

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		checked : Boolean Controla se este item de menu exibe uma marca de seleção.	NativeMenuItem
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		data : Object Um objeto de dados arbitrário associado a este item de menu.	NativeMenuItem
		enabled : Boolean Controla se este item de menu está ativado.	NativeMenuItem
		isSeparator : Boolean [somente leitura] Relata se este item é uma linha separadora de menu.	NativeMenuItem
		keyEquivalent : String O equivalente de tecla deste item de menu.	NativeMenuItem
		keyEquivalentModifiers : Array A matriz de códigos de tecla dos modificadores equivalentes de tecla.	NativeMenuItem
		label : String A string de exibição deste item de menu.	NativeMenuItem
		menu : NativeMenu [somente leitura] O menu que contém esse item.	NativeMenuItem
		mnemonicIndex : int A posição do caractere mnemônico no rótulo do item de menu.	NativeMenuItem
		name : String O nome deste item de menu.	NativeMenuItem
		submenu : NativeMenu O submenu associado a este item de menu.	NativeMenuItem

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	Método		Definido por
		NativeMenuItem(label:String = "", isSeparator:Boolean = false) Cria um novo objeto NativeMenuItem.	NativeMenuItem
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento.	EventDispatcher
		clone():NativeMenuItem Cria uma cópia do objeto NativeMenuItem.	NativeMenuItem
		dispatchEvent(event:Event):Boolean Envia um evento para o fluxo de eventos.	EventDispatcher
		hasEventListener(type:String):Boolean Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento.	EventDispatcher
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Remove um ouvinte do objeto EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String [substituir] Retorna uma string que contém todas as propriedades do objeto NativeMenuItem.	NativeMenuItem
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object
		willTrigger(type:String):Boolean Verifica se um ouvinte de evento está registrado nesse objeto EventDispatcher ou em qualquer um de seus ancestrais para o tipo de evento especificado.	EventDispatcher

Eventos

Clique para obter mais informações sobre eventos

Ocultar eventos herdados

Mostrar eventos herdados

	Resumo	Definido por
activate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR ganha o foco do sistema operacional e está se tornando inativo.	EventDispatcher
deactivate	[transmissão de evento] Despachado quando o Flash Player ou o aplicativo do AIR perde o foco do sistema operacional e está se tornando inativo.	EventDispatcher
displaying	Despachado por este objeto NativeMenuItem imediatamente antes que o menu que contém o item seja exibido.	NativeMenuItem
preparing	Despachado por este objeto NativeMenuItem quando o seu equivalente de tecla é pressionado e imediatamente antes da exibição do menu continente.	NativeMenuItem
select	Despachado sempre que um item de menu for selecionado pelo usuário.	NativeMenuItem

Detalhes da propriedade

checked

propriedade

checked:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

Controla se este item de menu exibe uma marca de seleção.

Implementação
public function get checked():Boolean
public function set checked(value:Boolean):void

data

propriedade

data:Object

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

Um objeto de dados arbitrário associado a este item de menu.

Você pode atribuir qualquer objeto a esta propriedade. O objeto atribuído não é usado pelo sistema de menu, mas está disponível para o código de manipulação de evento (através da propriedade de destino do objeto de evento). Por padrão, o valor dessa propriedade é null.

Implementação
public function get data():Object
public function set data(value:Object):void

enabled

propriedade

enabled:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

Controla se este item de menu está ativado.

Implementação
public function get enabled():Boolean
public function set enabled(value:Boolean):void

isSeparator

propriedade

isSeparator:Boolean [somente leitura]

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

Relata se este item é uma linha separadora de menu.

Crie uma linha separadora, definindo o parâmetro isSeparator no construtor NativeMenuItem como true.

Implementação
public function get isSeparator():Boolean

keyEquivalent

propriedade

keyEquivalent:String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

O equivalente de tecla deste item de menu.

Defina keyEquivalent com letra minúscula para atribuir um atalho sem um modificador da tecla Shift. Defina com uma letra maiúscula para atribuir um atalho com um modificador da tecla Shift.

Por padrão, o modificador equivalente de tecla (Ctrl no Windows ou no Linux e Command no Mac OS x) é incluído como parte do equivalente de tecla. Se desejar que o equivalente de tecla seja uma tecla sem modificador, defina a propriedade keyEquivalentModifiers como matriz vazia.

Implementação
public function get keyEquivalent():String
public function set keyEquivalent(value:String):void

keyEquivalentModifiers

propriedade

keyEquivalentModifiers:Array

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

A matriz de códigos de tecla dos modificadores equivalentes de tecla.

Use as constantes definidas na classe Keyboard para especificar os códigos de tecla do modificador. Os caracteres válidos do modificador incluem:

Keyboard.ALTERNATE
Keyboard.COMMAND
Keyboard.CONTROL

Se você não atribuir modificadores, então, por padrão, é atribuída a tecla Keyboard.CONTROL no Windows ou Linux e Keyboard.COMMAND no Mac OS X. Se você não quiser que o equivalente de tecla inclua esses modificadores, defina esta propriedade para uma matriz vazia.

Se você atribuir uma letra maiúsculas à propriedade keyEquivalent, usa-se a tecla Shift como modificador automaticamente. A definição de keyEquivalentModifier como matriz vazia não remove a tecla Shift como modificador.

Implementação
public function get keyEquivalentModifiers():Array
public function set keyEquivalentModifiers(value:Array):void

Elementos da API relacionados

flash.ui.Keyboard

label

propriedade

label:String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

A string de exibição deste item de menu.

Implementação
public function get label():String
public function set label(value:String):void

mnemonicIndex

propriedade

mnemonicIndex:int

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

A posição do caractere mnemônico no rótulo do item de menu.

O caractere na posição especificada é o caractere mnemônico do item de menu. O índice tem base zero, portanto, o primeiro caractere tem um índice de 0.

Esta propriedade é ignorada em sistemas operacionais que não usam mnemônicos de menu.

Implementação
public function get mnemonicIndex():int
public function set mnemonicIndex(value:int):void

name

propriedade

name:String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

O nome deste item de menu.

O valor de nome não é exibido e pode ser usado como identificador independente do local. Um nome não é atribuído automaticamente.

Implementação
public function get name():String
public function set name(value:String):void

submenu

propriedade

submenu:NativeMenu

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

O submenu associado a este item de menu.

Atribuir um objeto NativeMenu a esta propriedade muda a aparência e o comportamento do item de menu. O item de submenu exibe o ícone de submenu e não despacha mais os eventos select.

Observação: Adicionar um menu como um submenu de si mesmo (em uma referência circular) pode fazer com que um aplicativo seja desligado.

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

Elementos da API relacionados

flash.display.NativeMenu.addSubmenu()

Detalhes do construtor

()

Construtor

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

Cria um novo objeto NativeMenuItem.

Para criar um comando de menu, defina o parâmetro label como uma string que contém o rótulo de exibição e defina isSeparator como false.

Para criar um comando de submenu, crie um item de comando e, em seguida, atribua o objeto NativeMenu do submenu à propriedade submenu do item. Adicione o item ao menu pai.

Para criar um separador, defina o parâmetro label como uma string vazia e defina isSeparator como true.

Adicione e remova itens do menu usando os métodos addItem() e removeItem() do NativeMenu.

Parâmetros

	`label:String` (default = "") — O rótulo de exibição do item ou uma string vazia de separadores.

	`isSeparator:Boolean` (default = `false`) — Defina como `true` para criar um separador; defina como `false` caso contrário.

Elementos da API relacionados

flash.display.NativeMenu.addSubmenu()

Detalhes do método

clone

()

método

public function clone():NativeMenuItem

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

Cria uma cópia do objeto NativeMenuItem.

Retorna

NativeMenuItem

toString

()

método

override public function toString():String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

Retorna uma string que contém todas as propriedades do objeto NativeMenuItem.

Retorna

String — Uma string que contém todas as propriedades do objeto Event.

Detalhe do evento

displaying

Evento

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

Despachado por este objeto NativeMenuItem imediatamente antes que o menu que contém o item seja exibido.

O evento preparing excede o evento displaying e fornece funcionalidade adicional. Escute o evento preparing ou o evento displaying, mas não ambos.

A constante Event.DISPLAYING define o valor da propriedade type de um objeto de evento displaying.

Observação: Este evento não passa por uma "fase de captura" e é despachado diretamente ao destino, quer o destino esteja na exibição ou não.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`target`	O objeto que está prestes a ser exibido.

preparing

Evento

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 2.6

Despachado por este objeto NativeMenuItem quando o seu equivalente de tecla é pressionado e imediatamente antes da exibição do menu continente.

Escute este evento para atualizar o item antes que o menu continente seja exibido ou quando o seu equivalente de tecla for pressionado pelo usuário. O evento preparing é despachado antes que o equivalente de tecla seja avaliado por completo. Você pode ativar, desativar ou remover o item do menu no manipulador de eventos preparing, e essas modificações serão efetivas quando o equivalente de tecla for processado. Por exemplo, se você remover ou desativar este item de menu, então a sequência de eventos será efetivamente cancelada e nenhum evento select será despachado. A preparação o evento também é despachado por outros itens em um menu.

O evento preparing excede o evento displaying e fornece funcionalidade adicional. Escute o evento preparing ou o evento displaying, mas não ambos.

A constante Event.PREPARING define o valor da propriedade type de um objeto de eventopreparing.

Observação: Este evento não passa por uma "fase de captura" e é despachado diretamente ao destino, quer o destino esteja na exibição ou não.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`
`currentTarget`	O objeto que despachou este evento.
`target`	O objeto que despachou este evento.

select

Evento

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 1.0

Despachado sempre que um item de menu for selecionado pelo usuário.

Um evento select formará "bolhas" (bubbles) desse item para o menu que o contém e até a cadeia de menu pai para o objeto de menu raiz. A propriedade target do objeto de evento faz referência ao objeto NativeMenuItem; a propriedade currentTarget faz referência ao objeto de despacho (o objeto NativeMenuItem ou um objeto ancestral NativeMenu).

Observação:se a janela que contém o menu estiver em modo de tela cheia, o objeto NativeMenuItemstage.displayState == StageDisplayState.FULL_SCREEN não despachará um evento select quando o usuário inserir um equivalente de teclado para um item de menu.

A constante Event.SELECT define o valor da propriedade type de um objeto de evento select.

Esse evento tem as seguintes propriedades:

Propriedade	Valor
`bubbles`	`false`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`target`	O objeto no qual um item foi selecionado.

Aspectos jurídicos | Política de privacidade on-line

NativeMenuItem - AS3

Pacotesx

Elementos de linguagem

Apêndices

Pacote flash.display

checked

data

enabled

isSeparator

keyEquivalent

keyEquivalentModifiers

label

menu

mnemonicIndex

name

submenu

NativeMenuItem

clone

toString

displaying

preparing

select