| 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 |
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
falsepara o parâmetroisSeparator. - Para criar um submenu, crie um item de comando para o menu pai e atribua o objeto NativeMenu do submenu à propriedade de
submenudo item. Você também pode chamar o métodoaddSubmenu()do objeto NativeMenu nativo para criar o item e definir a propriedadesubmenuao mesmo tempo. - Para criar um separador, chame o construtor NativeMenuItem passando em uma string vazia para o rótulo e
truepara o parâmetroisSeparator.
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
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étodo | Definido por | ||
|---|---|---|---|
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 | |
Cria uma cópia do objeto NativeMenuItem. | NativeMenuItem | ||
|
Envia um evento para o fluxo de eventos. | EventDispatcher | |
|
Verifica se o objeto EventDispatcher tem ouvintes registrados para um tipo específico de evento. | EventDispatcher | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Remove um ouvinte do objeto EventDispatcher. | EventDispatcher | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
[substituir]
Retorna uma string que contém todas as propriedades do objeto NativeMenuItem. | NativeMenuItem | ||
|
Retorna o valor primitivo do objeto especificado. | Object | |
|
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 | |
| Evento | Resumo | Definido por | ||
|---|---|---|---|---|
| [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 | ||
| [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 | ||
| Despachado por este objeto NativeMenuItem imediatamente antes que o menu que contém o item seja exibido. | NativeMenuItem | |||
| Despachado por este objeto NativeMenuItem quando o seu equivalente de tecla é pressionado e imediatamente antes da exibição do menu continente. | NativeMenuItem | |||
| Despachado sempre que um item de menu for selecionado pelo usuário. | NativeMenuItem | |||
checked | propriedade |
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 |
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.ALTERNATEKeyboard.COMMANDKeyboard.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):voidElementos da API relacionados
label | propriedade |
menu | propriedade |
menu:NativeMenu [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O menu que contém esse item.
Implementação
public function get menu():NativeMenu 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):voidElementos da API relacionados
NativeMenuItem | () | 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.
label:String (default = " | |
isSeparator:Boolean (default = false)true para criar um separador; defina como false caso contrário.
|
Elementos da API relacionados
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.
RetornaNativeMenuItem |
toString | () | método |
displaying | Evento |
flash.events.Eventpropriedade 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.
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 |
flash.events.Eventpropriedade 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.
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 |
flash.events.Eventpropriedade 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.
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. |
Wed Jun 13 2018, 11:10 AM Z