| Pacote | flash.desktop |
| Classe | public final class NativeApplication |
| Herança | NativeApplication  EventDispatcher Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
A classe NativeApplication fornece informações sobre o aplicativo e funções no âmbito do aplicativo, e despacha eventos no nível do aplicativo.
O objeto NativeApplication é um objeto singleton criado automaticamente na inicialização. Obtenha a ocorrência NativeApplication de um aplicativo com o NativeApplication.nativeApplication de propriedade estática.
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
| activeWindow : NativeWindow [somente leitura]
A janela do aplicativo ativo. | NativeApplication | ||
| applicationDescriptor : XML [somente leitura]
O conteúdo do arquivo do descritor do aplicativo para esse aplicativo AIR. | NativeApplication | ||
| applicationID : String [somente leitura]
O ID desse aplicativo. | NativeApplication | ||
| autoExit : Boolean
Especifica se o aplicativo deverá encerrar automaticamente quando todas as janelas tiverem sido fechadas. | NativeApplication | ||
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| executeInBackground : Boolean
Especifica se o aplicativo será executado em segundo plano ou não. | NativeApplication | ||
| icon : InteractiveIcon [somente leitura]
O ícone do aplicativo. | NativeApplication | ||
| idleThreshold : int
O número de segundos que deve transcorrer sem entrada do usuário antes que um evento userIdle seja despachado. | NativeApplication | ||
| isCompiledAOT : Boolean [somente leitura]
Especifica se o aplicativo foi compilado ou interpretado para a plataforma desejada. | NativeApplication | ||
| menu : NativeMenu
O menu do aplicativo. | NativeApplication | ||
| nativeApplication : NativeApplication [estático] [somente leitura]
A ocorrência singleton do objeto NativeApplication. | NativeApplication | ||
| openedWindows : Array [somente leitura]
Uma matriz contendo todas as janelas nativas abertas deste aplicativo. | NativeApplication | ||
| publisherID : String [somente leitura]
O ID do editor desse aplicativo. | NativeApplication | ||
| runtimePatchLevel : uint [somente leitura]
O nível do pacote do tempo de execução que hospeda este aplicativo. | NativeApplication | ||
| runtimeVersion : String [somente leitura]
O número de versão do tempo de execução que hospeda este aplicativo. | NativeApplication | ||
| startAtLogin : Boolean
Especifica se o aplicativo é automaticamente iniciado sempre que o usuário atual efetuar login. | NativeApplication | ||
| supportsDefaultApplication : Boolean [estático] [somente leitura]
Indica se há suporte para setAsDefaultApplication(), removeAsDefaultApplication() e isSetAsDefaultApplication() na plataforma atual. | NativeApplication | ||
| supportsDockIcon : Boolean [estático] [somente leitura]
Indica se o AIR suporta ícones de encaixe do aplicativo no sistema operacional atual. | NativeApplication | ||
| supportsMenu : Boolean [estático] [somente leitura]
Especifica se o sistema operacional atual suporta uma barra de menu de aplicativo global. | NativeApplication | ||
| supportsStartAtLogin : Boolean [estático] [somente leitura]
Indica se startAtLogin é suportado na plataforma atual. | NativeApplication | ||
| supportsSystemTrayIcon : Boolean [estático] [somente leitura]
Especifica se o AIR suporta ícones da bandeja do sistema no sistema operacional atual. | NativeApplication | ||
| systemIdleMode : String
Fornece uma maneira para que os aplicativos impeçam a interface do usuário de entrar no modo "ocioso". | NativeApplication | ||
| timeSinceLastUserInput : int [somente leitura]
A hora, em segundos, desde a última entrada do usuário. | NativeApplication | ||
| Método | Definido por | ||
|---|---|---|---|
Ativa esse aplicativo. | NativeApplication | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [substituir]
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. | NativeApplication | ||
Invoca um comando de exclusão interno no objeto exibido focalizado. | NativeApplication | ||
Invoca um comando copiar interno no objeto de exibição focalizado. | NativeApplication | ||
Invoca um comando de corte interno no objeto de exibição focalizado. | NativeApplication | ||
[substituir]
Envia um evento para o fluxo de eventos. | NativeApplication | ||
Encerra esse aplicativo. | NativeApplication | ||
Obtém o aplicativo padrão para a abertura de arquivos com a extensão especificada. | NativeApplication | ||
|
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 | |
Especifica se esse aplicativo é atualmente o aplicativo padrão para a abertura de arquivos com a extensão especificada. | NativeApplication | ||
Invoca um comando de colagem interno no objeto de exibição focalizado. | NativeApplication | ||
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
Remove esse aplicativo como o padrão para a abertura de arquivos com a extensão especificada. | NativeApplication | ||
[substituir]
Remove um ouvinte do objeto EventDispatcher. | NativeApplication | ||
Invoca um comando selectAll interno no objeto de exibição focalizado. | NativeApplication | ||
Define esse aplicativo como o aplicativo padrão para a abertura de arquivos com a extensão especificada. | NativeApplication | ||
|
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 | |
|
Retorna a representação de string do objeto especificado. | Object | |
|
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 | ||
|---|---|---|---|---|
| Despachado quando esse aplicativo se torna o aplicativo ativo da área de trabalho. | NativeApplication | |||
| Despachado quando um aplicativo é chamado por um arquivo SWF em execução no navegador do usuário. | NativeApplication | |||
| Despachado quando o foco da área de trabalho é alternado para um aplicativo diferente. | NativeApplication | |||
| Despachado quando a sequência de saída do aplicativo é iniciada. | NativeApplication | |||
| Despachado quando um aplicativo é invocado. | NativeApplication | |||
| Despachado quando o usuário pressiona uma tecla. | NativeApplication | |||
| Despachado quando o usuário solta uma tecla. | NativeApplication | |||
| Despachado quando uma nova conexão de rede se torna disponível ou uma conexão de rede existente está perdida. | NativeApplication | |||
| Despachado quando o aplicativo está a ponto de ser suspenso pelo sistema operacional. | NativeApplication | |||
| Despachado quando o usuário ficou ocioso. | NativeApplication | |||
| Despachado quando o sistema operacional detecta a atividade do mouse ou do teclado após um período de ociosidade. | NativeApplication | |||
activeWindow | propriedade |
activeWindow:NativeWindow [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
A janela do aplicativo ativo.
Se a janela da área de trabalho ativa não pertencer a esse aplicativo, ou não houver nenhuma janela ativa, activeWindow será null.
Esta propriedade não é compatível com plataformas que não oferecem suporte à classe NativeWindow.
Implementação
public function get activeWindow():NativeWindow applicationDescriptor | propriedade |
applicationDescriptor:XML [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O conteúdo do arquivo do descritor do aplicativo para esse aplicativo AIR.
Implementação
public function get applicationDescriptor():XMLExemplo ( Como usar este exemplo )
copyright e version do arquivo do descritor do aplicativo. Observe que você deverá usar o namespace padrão definido no XML do descritor do aplicativo.
var appDescriptor:XML = NativeApplication.nativeApplication.applicationDescriptor;
var ns:Namespace = appDescriptor.namespace();
var appCopyright:String = appDescriptor.ns::copyright;
var appVersion:String = appDescriptor.ns::version;
trace("appId:", appCopyright);
trace("version:", appVersion);
applicationID | propriedade |
autoExit | propriedade |
autoExit:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Especifica se o aplicativo deverá encerrar automaticamente quando todas as janelas tiverem sido fechadas.
Quando autoExit for true, que é o padrão, o aplicativo encerra quando todas as janelas forem fechadas. Ambos os eventos exiting e exit são despachados. Quando autoExit for false, você deverá chamar NativeApplication.nativeApplication.exit() para encerrar o aplicativo.
Esta propriedade não é compatível com plataformas que não oferecem suporte à classe NativeWindow.
Implementação
public function get autoExit():Boolean public function set autoExit(value:Boolean):void executeInBackground | propriedade |
executeInBackground:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.3 |
Especifica se o aplicativo será executado em segundo plano ou não.
Quando executeInBackground é falso, que é o padrão, o aplicativo permanece no estado suspenso quando vai para segundo plano. Quando executeInBackground é verdadeiro, o aplicativo pode ser executado em segundo plano.
Observação: com o swf versão 21 e suas versões anteriores, o AIR não oferece suporte a execução em segundo plano no iOS e Android quando o modo de renderização estiver definido como direto. Devido a essa restrição, os aplicativos baseados em Stage3D não conseguem executar tarefas em segundo plano, como reprodução de áudio, atualizações de locais, upload ou download de rede, etc. O iOS não permite renderização de chamadas ou OpenGLES em segundo plano. Aplicativos que tentam fazer chamadas OpenGL em segundo plano são encerrados pelo iOS. O Android não restringe aplicativos de realizar chamadas OpenGLES em segundo plano ou outra tarefa em segundo plano, como reprodução de áudio. Com o swf-versão 22 e posterior, os aplicativos móveis do AIR podem ser executados em segundo plano quando o renderMode estiver definido como direto. O runtime do iOS AIR resulta em um erro de ActionScript (3768 - a API Stage3D não pode ser usada durante a execução em segundo plano) se as chamadas de OpenGLES forem executadas em segundo plano. Entretanto, não há erros em Android pois seus aplicativos nativos podem realizar chamadas de OpenGLES em segundo plano. Para o uso ideal do recurso remoto, não faça chamadas de renderização enquanto um aplicativo é executado em segundo plano.
Essa propriedade é suportada no AIR para iOS e para Android.
Implementação
public function get executeInBackground():Boolean public function set executeInBackground(value:Boolean):void icon | propriedade |
icon:InteractiveIcon [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O ícone do aplicativo.
Use NativeApplication.supportsDockIcon e NativeApplication.supportsSystemTrayIcon para determinar a classe de ícones. O tipo será uma das subclasses de InteractiveIcon. No Mac® OS X, NativeApplication.icon é um objeto do tipo DockIcon. No Windows®, NativeApplication.icon é um objeto do tipo SystemTrayIcon. Quando um ícone do aplicativo não for suportado, NativeApplication.supportsDockIcon e NativeApplication.supportsSystemTrayIcon são false e a propriedade icon é null.
O objeto icon é automaticamente criado, mas não é inicializado com os dados da imagem. Em alguns sistemas operacionais, como o Mac OS X, é fornecida uma imagem padrão. Em outros, como o Windows, o ícone não é exibido a menos que os dados de imagem sejam a ele atribuídos. Para atribuir a imagem de um ícone, defina a propriedade icon.bitmaps com uma matriz contendo ao menos um objeto BitmapData. Se mais de um objeto BitmapData for incluído na matriz, então, o sistema operacional escolhe a imagem mais próxima do tamanho das dimensões de exibição do ícone, escalando a imagem se necessário.
Implementação
public function get icon():InteractiveIconElementos da API relacionados
idleThreshold | propriedade |
idleThreshold:int| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O número de segundos que deve transcorrer sem entrada do usuário antes que um evento userIdle seja despachado.
Por padrão, o limite de ociosidade é de 300 segundos (5 minutos). A faixa de valores aceitável é de 5 (5 segundos) a 86.400 (1 dia).
Implementação
public function get idleThreshold():int public function set idleThreshold(value:int):voidLança
ArgumentError — Se você tenta definir a propriedade para um valor inválido. A faixa de valores aceitável é de 5 (5 segundos) a 86.400 (1 dia).
|
Elementos da API relacionados
isCompiledAOT | propriedade |
isCompiledAOT:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 25.0 |
Especifica se o aplicativo foi compilado ou interpretado para a plataforma desejada. Essa API retorna (true) apenas para o iOS de destino (ipa-app-store, ipa-test, ipa-debug, ipa-ad-hoc). Para outras plataformas AIR, essa API retorna (false).
Implementação
public function get isCompiledAOT():Boolean menu | propriedade |
menu:NativeMenu| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O menu do aplicativo.
Os menus de aplicativos serão suportados quando NativeApplication.supportsMenu for true. Nem todos os sistemas operacionais suportam menus de aplicativos. Por exemplo, os menus de aplicativos são suportados no Mac OS X, mas não no Windows ou no Linux. Atribuir um objeto NativeMenu a essa propriedade quando NativeApplication.supportsMenu for false será permitido, mas não terá efeito algum. Certifique-se de usar a propriedade NativeApplication.supportsMenu para determinar se o sistema operacional suporta menus do aplicativo. Usar outros meios (tais como Capabilities.os) para determinar o suporte que podem causar erros programados (se algum sistema operacional de destino não foi considerado).
Suporte a perfil do AIR: este recurso não é compatível com dispositivos móveis nem com dispositivos AIR for TV. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Observação: No Mac OS X, a propriedade menu faz referência ao menu do aplicativo padrão fornecido pelo sistema operacional. Você pode modificar a estrutura de menu existente adicionando e removendo itens e submenus, e adicionando ouvintes de eventos. Você também pode substituir inteiramente os menus padrão atribuindo um novo objeto NativeMenu a esta propriedade menu.
Implementação
public function get menu():NativeMenu public function set menu(value:NativeMenu):voidElementos da API relacionados
nativeApplication | propriedade |
nativeApplication:NativeApplication [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
A ocorrência singleton do objeto NativeApplication.
Implementação
public static function get nativeApplication():NativeApplicationLança
Error — Se acessado por conteúdo externo à caixa de proteção do aplicativo.
|
openedWindows | propriedade |
openedWindows:Array [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Uma matriz contendo todas as janelas nativas abertas deste aplicativo.
Esta propriedade não é compatível com plataformas que não oferecem suporte à classe NativeWindow.
Implementação
public function get openedWindows():Array publisherID | propriedade |
publisherID:String [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
O ID do editor desse aplicativo.
O valor desse ID é definido no arquivo publisherid do aplicativo, que é gerado na instalação a partir da cadeia de certificados usada para assinar o aplicativo.
Implementação
public function get publisherID():String runtimePatchLevel | propriedade |
runtimeVersion | propriedade |
startAtLogin | propriedade |
startAtLogin:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Especifica se o aplicativo é automaticamente iniciado sempre que o usuário atual efetuar login.
Suporte a perfil do AIR: este recurso conta com suporte em todos os sistemas operacionais para desktop, mas não é compatível com dispositivos móveis nem com dispositivos AIR for TV. Você pode testar o suporte que em tempo de execução utilizando a propriedadeNativeApplication.supportsStartAtLogin. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
A propriedade startAtLogin reflete o status do mecanismo definido pelo sistema operacional para designar que um aplicativo deverá iniciar automaticamente quando um usuário efetuar login. O usuário pode alterar o status manualmente usando a interface do usuário do sistema operacional. Essa propriedade refletirá o status atual caso o status tenha sido alterado a última vez pelo aplicativo AIR ou pelo sistema operacional.
Implementação
public function get startAtLogin():Boolean public function set startAtLogin(value:Boolean):voidLança
IllegalOperationError — No Windows, quando outro aplicativo com o mesmo nome (mas com um caminho diferente para o executável) já estiver definido para iniciar quando esse usuário efetua login.
| |
IllegalOperationError — Se esse aplicativo não estiver instalado, o que pode ser o caso quando iniciado pelo AIR Debug Launcher (ADL).
|
Elementos da API relacionados
supportsDefaultApplication | propriedade |
supportsDefaultApplication:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
Indica se há suporte para setAsDefaultApplication(), removeAsDefaultApplication() e isSetAsDefaultApplication() na plataforma atual.
Se true, os métodos acima mencionados funcionarão como documentado. Se false, setAsDefaultApplication() e removeDefaultApplication() não farão nada e isSetAsDefaultApplication() retornará false.
Implementação
public static function get supportsDefaultApplication():BooleanElementos da API relacionados
supportsDockIcon | propriedade |
supportsDockIcon:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Indica se o AIR suporta ícones de encaixe do aplicativo no sistema operacional atual.
Se for true, a propriedade NativeApplication.icon é do tipo DockIcon.
A interface do usuário X do SO de Mac fornece um aplicativo "dock" que contém ícones de aplicativos que estão sendo executados ou são frequentemente usados.
Certifique-se de usar a propriedade NativeApplication.supportsDockIcon para determinar se o sistema operacional suporta ícones de encaixe de aplicativo. Usar outros meios (tais como Capabilities.os) para determinar o suporte que podem causar erros programados (se algum sistema operacional de destino não foi considerado).
Implementação
public static function get supportsDockIcon():BooleanElementos da API relacionados
supportsMenu | propriedade |
supportsMenu:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Especifica se o sistema operacional atual suporta uma barra de menu de aplicativo global.
Quando true, a propriedade NativeApplication.menu pode ser usada para definir (ou acessar) um menu de aplicativo nativo.
Certifique-se de usar a propriedade NativeApplication.supportsMenu para determinar se o sistema operacional suporta a barra de menu do aplicativo. Usar outros meios (tais como Capabilities.os) para determinar o suporte que podem causar erros programados (se algum sistema operacional de destino não foi considerado).
Implementação
public static function get supportsMenu():BooleanElementos da API relacionados
supportsStartAtLogin | propriedade |
supportsStartAtLogin:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
Indica se startAtLogin é suportado na plataforma atual.
Se true, então o startAtLogin trabalhará como documentado. Se false, então o startAtLogin não terá nenhum efeito.
Implementação
public static function get supportsStartAtLogin():BooleanElementos da API relacionados
supportsSystemTrayIcon | propriedade |
supportsSystemTrayIcon:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Especifica se o AIR suporta ícones da bandeja do sistema no sistema operacional atual.
Se for true, a propriedade NativeApplication.icon é do tipo SystemTrayIcon.
A interface do usuário do Windows fornece a região "bandeja do sistema" da barra de tarefas, oficialmente chamada Área de notificação, em que os ícones do aplicativo podem ser exibidos. Nenhum ícone padrão é mostrado. Você deve definir o a matriz de bitmaps do objeto de ícone para exibir um ícone.
Certifique-se de usar a propriedade NativeApplication.supportsSystemTrayIcon para determinar se o sistema operacional suporta ícones de bandeja do sistema. Usar outros meios (tais como Capabilities.os) para determinar o suporte que podem causar erros programados (se algum sistema operacional de destino não foi considerado).
Implementação
public static function get supportsSystemTrayIcon():BooleanElementos da API relacionados
systemIdleMode | propriedade |
systemIdleMode:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 2 |
Fornece uma maneira para que os aplicativos impeçam a interface do usuário de entrar no modo "ocioso".
Um valor da classe SystemIdleMode para influir no comportamento de modo ocioso do sistema host. Esta propriedade só é eficaz para o aplicativo com o foco de entrada e só pode ser acessada do conteúdo que executa na caixa de proteção de aplicativo.
Suporte a perfil do AIR: este recurso conta com suporte em dispositivos móveis, mas não é compatível com sistemas operacionais para desktop nem com dispositivos AIR for TV. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Implementação
public function get systemIdleMode():String public function set systemIdleMode(value:String):voidElementos da API relacionados
timeSinceLastUserInput | propriedade |
activate | () | método |
public function activate(window:NativeWindow = null):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Ativa esse aplicativo.
Este método não é compatível com plataformas que não oferecem suporte à classe NativeWindow.
Sob algumas circunstâncias determinadas pelo sistema operacional, esse método não ativa um aplicativo. A maioria dos sistemas operacionais restringe a capacidade de um aplicativo de ativar a si próprio para evitar que isso ocorra de forma acidental ou maliciosa, impossibilitando um usuário de usar outros aplicativos.
Se o sistema operacional permitir a ativação, então, a janela especificada é ativada e trazida para o primeiro plano da área de trabalho, ou seja, na frente das janelas de outros aplicativos. (Se o parâmetro window for null, então, um janela visível deste aplicativo será ativada.)
O método activate() não terá efeito se o aplicativo não tiver janelas visíveis.
A operação de ativação é síncrona.
Parâmetros
window:NativeWindow (default = null) |
Eventos
activate: — Despachado se o estado da ativação for alterado.
|
addEventListener | () | método |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| Versões de runtime: | AIR 1.0 |
Registra um objeto de ouvinte de evento em um objeto EventDispatcher, de forma que o ouvinte receba a notificação de um evento. Você pode registrar ouvintes de eventos em todos os nós da lista de exibição de um tipo específico de evento, fase e prioridade.
Depois de registrar um ouvinte de evento com êxito, não será possível alterar a respectiva prioridade por meio de chamadas adicionais para o addEventListener(). Para alterar a prioridade de um ouvinte, chame primeiramente o removeListener(). Em seguida, você poderá registrar o ouvinte novamente com o novo nível de prioridade.
Tenha em mente que, após o ouvinte ser registrado, chamadas subsequentes para o addEventListener() com um valor type ou useCapture diferente resultarão na criação de um registro de ouvinte separado. Por exemplo, se você primeiro registrar um ouvinte com o useCapture definido como true, ele escutará apenas durante a fase de captura. Se você chamar o addEventListener() novamente, usando o mesmo objeto de ouvinte, mas com o useCapture definido como false, você terá dois ouvintes distintos: um que escuta durante a fase de captura e outro que escuta durante as fases de destino e de bubbling.
Você não pode registrar um ouvinte de evento apenas para a fase de destino ou a fase de bubbling. Essas fases são emparelhadas durante o registro porque o bubbling se aplica apenas aos ancestral do nó-alvo.
Se você não precisar mais de um ouvinte de evento, remova-o, chamando o removeEventListener(); do contrário, poderão ocorrer problemas de memória. Os ouvintes de evento não são retirados automaticamente da memória porque o coletor de lixo não remove o ouvinte enquanto o objeto de despacho existe (a menos que o parâmetro useWeakReference seja definido para true).
Copiar uma ocorrência do EventDispatcher não copia os ouvintes de eventos a ele anexados. (Se o seu recém-criado nó precisar de um ouvinte de evento, anexe o ouvinte após criar o nó). Entretanto, se você mover uma ocorrência do EventDispatcher, os ouvintes de evento anexados se movimentarão com ele.
Se o ouvinte de evento estiver sendo registrado em um nó enquanto um evento estiver sendo processado nesse nó, o ouvinte de evento não será disparado durante a fase atual, mas poderá ser disparado durante uma fase posterior no fluxo de eventos, como a fase de bubbling.
Se um ouvinte de evento for removido de um nó enquanto um evento estiver sendo processado no nó, ele ainda será disparado pelas ações atuais. Depois de removido, o ouvinte de evento nunca mais é chamado novamente (a menos que registrado mais uma vez para processamento futuro).
Parâmetros
type:String — O tipo de evento.
| |
listener:Function — A função de ouvinte que processa o evento. Esta função deve aceitar um objeto Event como seu único parâmetro e não deve retornar nada, como mostra este exemplo:
function(evt:Event):void A função pode ter qualquer nome. | |
useCapture:Boolean (default = false)useCapture for definido como true, o ouvinte processará o evento apenas durante a fase de captura e não na fase de destino nem de bubbling. Se useCapture for false, o ouvinte processará o evento apenas durante a fase de destino ou de bubbling. Para ouvir o evento em todas as três fases, chame o addEventListener duas vezes, uma vez com o useCapture definido como true, e novamente, com o useCapture definido como false.
| |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false)Funções de membro de nível de classe não estão sujeitas à coleta de lixo, portanto, você pode definir |
clear | () | método |
public function clear():Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Invoca um comando de exclusão interno no objeto exibido focalizado.
Essa chamada de função será ignorada se o objeto focalizado não implementar o comando. Exibir somente os objetos descendentes das classes TextField ou HTMLLoader implementa atualmente esse comando.
Observação: o comando clear() exclui o texto selecionado. Não limpará todo o texto se nada for selecionado.
Boolean — true.
|
copy | () | método |
public function copy():Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Invoca um comando copiar interno no objeto de exibição focalizado.
Essa chamada de função será ignorada se o componente não implementar o comando. Exibir somente os objetos descendentes das classes TextField ou HTMLLoader implementa atualmente esse comando.
RetornaBoolean |
cut | () | método |
public function cut():Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Invoca um comando de corte interno no objeto de exibição focalizado.
Essa chamada de função será ignorada se o componente não implementar o comando. Exibir somente os objetos descendentes das classes TextField ou HTMLLoader implementa atualmente esses comandos.
RetornaBoolean — true.
|
dispatchEvent | () | método |
override public function dispatchEvent(event:Event):Boolean| Versões de runtime: | AIR 1.0 |
Envia um evento para o fluxo de eventos. O destino de evento é o objeto EventDispatcher no qual o método dispatchEvent() é chamado.
Parâmetros
event:Event — O objeto Event que é despachado para o fluxo de eventos. Se o evento estiver sendo redespachado, um clone desse evento será criado automaticamente. Depois que um evento é despachado, sua propriedade target não pode ser alterada, portanto, você pode criar uma nova cópia do evento para reenviar para trabalho.
|
Boolean — Um valor true se o evento foi despachado com sucesso. Um valor false indica falha ou que o preventDefault() foi chamado no evento.
|
exit | () | método |
public function exit(errorCode:int = 0):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Encerra esse aplicativo.
A chamada do método exit() será retornada; a sequência de encerramento não é iniciada até que o código de execução atual (como um manipulador de eventos atual) seja concluído. As operações assincrônicas pendentes são canceladas e podem ou não ser concluídas.
Observe que o evento exiting não será despachado. Se um evento exiting for exigido pela lógica do aplicativo, chame NativeApplication.nativeApplication.dispatchEvent(), passando um objeto Event do tipo exiting. Para qualquer janela aberta, os objetos NativeWindow despacham eventos closing e close. Chamar o método preventDefault() do evento closing evita que o aplicativo saia.
Nota: este método não é compatível com o sistema operacional iOS.
Parâmetros
errorCode:int (default = 0) |
getDefaultApplication | () | método |
public function getDefaultApplication(extension:String):String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Obtém o aplicativo padrão para a abertura de arquivos com a extensão especificada.
Observação: Esse método só pode ser usado com os tipos de arquivos declarados na instrução fileTypes do descritor do aplicativo.
Este método não é aplicável para dispositivos AIR for TV. Se você o chamar com um tipo de arquivo declarado no descritor de aplicativo, ele retornará null.
Parâmetros
extension:String — Uma String contendo a extensão do tipo de arquivo de interesse (sem o ".").
|
String — O caminho do aplicativo padrão.
|
Lança
Error — Se o parâmetro extension não contiver uma das extensões de arquivo declaradas no descritor do aplicativo.
|
Elementos da API relacionados
isSetAsDefaultApplication | () | método |
public function isSetAsDefaultApplication(extension:String):Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Especifica se esse aplicativo é atualmente o aplicativo padrão para a abertura de arquivos com a extensão especificada.
Suporte a perfil do AIR: este recurso conta com suporte em todos os sistemas operacionais para desktop, mas não é compatível com dispositivos móveis nem com dispositivos AIR for TV. Você pode testar o suporte que em tempo de execução utilizando a propriedadeNativeApplication.supportsDefaultApplication. Consulte Suporte a perfil do AIR para obter mais informações sobre o suporte de API através de múltiplos perfis.
Parâmetros
extension:String — Uma String contendo a extensão do tipo de arquivo de interesse (sem o ".").
|
Boolean — true se esse aplicativo for o padrão.
|
Lança
Error — Se o parâmetro extension não contiver uma das extensões de arquivo declaradas no descritor do aplicativo.
|
Elementos da API relacionados
paste | () | método |
public function paste():Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Invoca um comando de colagem interno no objeto de exibição focalizado.
Essa chamada de função será ignorada se o componente não implementar o comando. Exibir somente os objetos descendentes das classes TextField ou HTMLLoader implementa atualmente esse comando.
RetornaBoolean — true.
|
removeAsDefaultApplication | () | método |
public function removeAsDefaultApplication(extension:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Remove esse aplicativo como o padrão para a abertura de arquivos com a extensão especificada.
Observação: Esse método só pode ser usado com os tipos de arquivos relacionados na instrução fileTypes no descritor do aplicativo.
Parâmetros
extension:String — Uma String contendo a extensão do tipo de arquivo de interesse (sem o ".").
|
Lança
Error — Se o parâmetro extension não contiver uma das extensões de arquivo declaradas no descritor do aplicativo.
|
Elementos da API relacionados
removeEventListener | () | método |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| Versões de runtime: | AIR 1.0 |
Remove um ouvinte do objeto EventDispatcher. Se não existir um ouvinte correspondente registrado com o objeto EventDispatcher, uma chamada para esse método não terá efeito.
Parâmetros
type:String — O tipo de evento.
| |
listener:Function — O objeto de ouvinte a remover.
| |
useCapture:Boolean (default = false)removeEventListener() serão necessárias para remover as duas, uma chamada com o useCapture() definido como true e outra chamada com o useCapture() definido como false.
|
selectAll | () | método |
public function selectAll():Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Invoca um comando selectAll interno no objeto de exibição focalizado.
Essa chamada de função será ignorada se o componente não implementar o comando. Exibir somente os objetos descendentes das classes TextField ou HTMLLoader implementa atualmente esse comando.
RetornaBoolean — true.
|
setAsDefaultApplication | () | método |
public function setAsDefaultApplication(extension:String):void| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Define esse aplicativo como o aplicativo padrão para a abertura de arquivos com a extensão especificada.
Observação: Esse método só pode ser usado com os tipos de arquivos declarados na instrução fileTypes no descritor do aplicativo.
Parâmetros
extension:String — Uma String contendo a extensão do tipo de arquivo de interesse (sem o ".").
|
Lança
Error — Se o parâmetro extension não contiver uma das extensões de arquivo declaradas no descritor do aplicativo.
|
Elementos da API relacionados
activate | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.ACTIVATE| Versões de runtime: | AIR 1.0 |
Despachado quando esse aplicativo se torna o aplicativo ativo da área de trabalho.
A constanteACTIVATE define o valor da propriedade type de um objeto de evento activate.
Observação: Esse evento não tem uma "fase de captura" nem "fase de bubble", significando que os ouvintes de evento precisam ser adicionados diretamente a qualquer destino possível que esteja ou não na lista de exibição.
Dispositivos AIR for TV nunca emitem este evento automaticamente. Você pode, contudo, emiti-lo manualmente.
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 | Qualquer ocorrência do DisplayObject com um ouvinte registrado para o evento activate. |
browserInvoke | Evento |
flash.events.BrowserInvokeEventpropriedade BrowserInvokeEvent.type =
flash.events.BrowserInvokeEvent.Browser_INVOKE| Versões de runtime: | AIR 1.0 |
Despachado quando um aplicativo é chamado por um arquivo SWF em execução no navegador do usuário.
A invocação do navegador só é permitida se um aplicativo especificar o seguinte no arquivo de descrição do aplicativo:
<allowBrowserInvocation>true</allowBrowserInvocation>
deactivate | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.DEACTIVATE| Versões de runtime: | AIR 1.0 |
Despachado quando o foco da área de trabalho é alternado para um aplicativo diferente.
A constanteEvent.DEACTIVATE define o valor da propriedade type de um objeto de evento deactivate.
Observação: Esse evento não tem uma "fase de captura" nem "fase de bubble", significando que os ouvintes de evento precisam ser adicionados diretamente a qualquer destino possível que esteja ou não na lista de exibição.
Dispositivos AIR for TV nunca emitem este evento automaticamente. Você pode, contudo, emiti-lo manualmente.
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 | Qualquer ocorrência do DisplayObject com um ouvinte registrado para o evento deactivate. |
exiting | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.EXITING| Versões de runtime: | AIR 1.0 |
Despachado quando a sequência de saída do aplicativo é iniciada.
O evento exiting é despachado quando a saída do aplicativo é iniciada pelo sistema operacional. Por exemplo, quando o usuário emite a sequência de teclas Cmd-Q no Mac OS X, ou quando a propriedade autoExit do objeto NativeApplication for true e a última janela do aplicativo estiver fechada. O cancelamento desse evento impede a saída do aplicativo.
Dispositivos AIR for TV nunca emitem o evento exiting.
Nota: chamar o método exit() do NativeApplication não faz com que um evento exiting seja despachado. Para avisar os componentes quanto a uma saída iminente, emita o evento exiting antes de chamar exit().
Event.EXITING define o valor da propriedade type de um objeto de evento exiting.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | true; cancelar esse objeto de evento para a operação de saída. |
currentTarget | O objeto NativeApplication. |
target | O objeto NativeApplication. |
invoke | Evento |
flash.events.InvokeEventpropriedade InvokeEvent.type =
flash.events.InvokeEvent.INVOKE| Versões de runtime: | AIR 1.0 |
Despachado quando um aplicativo é invocado.
Quando um aplicativo é invocado uma segunda vez, uma outra ocorrência do aplicativo não é iniciada. Em vez disso, a primeira ocorrência recebe um evento de invocação adicional. É tarefa do aplicativo manipular os eventos invoke subsequentes apropriadamente.
Observação: Todos os eventos invoke são colocados em fila. Quando um ouvinte desse evento for registrado, ele recebe todos os eventos na fila, bem como qualquer evento novo. Os eventos em fila pode ser entregues antes ou depois de qualquer novo evento invoke.
InvokeEvent.INVOKE define o valor da propriedade type de um objeto InvokeEvent.
O objeto InvokeEvent tem as seguintes propriedades:
| Propriedades | Valores |
|---|---|
arguments | A matriz dos argumentos da string transmitida durante esta invocação. |
currentDirectory | O objeto File que representa o diretório que deve ser usado para resolver todos os caminhos relativos na matriz de argumentos. |
motivo | um código que indica se o evento invocar foi despachado porque o aplicativo iniciou automaticamente no login (InvokeEventReason.LOGIN), iniciado como uma resposta a uma notificação remota (InvokeEventReason.NOTIFICATION - somente iOS) por que o aplicativo foi invocado por outro aplicativo(InvokeEventReason.OPEN_URL) ou por outra razão (InvokeEventReason.STANDARD). Disponível desde a versão 1.5.1 de AIR. |
bubbles | false. |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | Indica o objeto que está processando ativamente o objeto InvokeEvent com um ouvinte de evento. |
target | Sempre o objeto NativeApplication. |
keyDown | Evento |
flash.events.KeyboardEventpropriedade KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Despachado quando o usuário pressiona uma tecla. A instância NativeApplication fornece este evento para suportar aceleradores de teclado. Este evento keyboard é despachado primeiramente para o NativeApplication. Cancelar este evento também cancela aceleradores de menu NativeWindow. Esse evento ocorre antes do evento keyUp.
KeyboardEvent.KEY_DOWN define o valor da propriedade type de um objeto de evento keyDown.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | true em AIR, false em Flash Player; no AIR, o cancelamento deste evento impede o caractere de ser introduzido em um campo de texto. |
charCode | O valor de código de caractere da tecla pressionada ou solta. |
commandKey | true no Mac caso a tecla Command esteja ativa. Caso contrário, false |
controlKey | true no Windows e no Linux caso a tecla Ctrl esteja ativa. true no Mac caso a tecla Control esteja ativa. Caso contrário, false |
ctrlKey | true no Windows e no Linux caso a tecla Ctrl esteja ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
keyCode | O valor de código da tecla pressionada ou solta. |
keyLocation | O local da tecla no teclado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject com foco. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
keyUp | Evento |
flash.events.KeyboardEventpropriedade KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
Despachado quando o usuário solta uma tecla. A instância NativeApplication fornece este evento para suportar aceleradores de teclado. Este evento keyboard é despachado primeiramente para o NativeApplication. Cancelar este evento não tem nenhum efeito em outros objetos (tais como aceleradores de menu NativeWindow). Este evento ocorre depois do evento keyDown.
KeyboardEvent.KEY_UP define o valor da propriedade type de um objeto de evento keyUp.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | true |
cancelable | false; não há comportamento padrão a ser cancelado. |
charCode | Contém o valor de código de caractere da tecla pressionada ou solta. |
commandKey | true no Mac caso a tecla Command esteja ativa. Caso contrário, false |
controlKey | true no Windows e no Linux caso a tecla Ctrl esteja ativa. true no Mac caso a tecla Control esteja ativa. Caso contrário, false |
ctrlKey | true no Windows se a tecla Ctrl estiver ativa. true no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, false. |
currentTarget | O objeto que está processando ativamente o objeto Event com um ouvinte de evento. |
keyCode | O valor de código da tecla pressionada ou solta. |
keyLocation | O local da tecla no teclado. |
shiftKey | true se a tecla Shift estiver ativa; false se estiver inativa. |
target | A ocorrência InteractiveObject com foco. target não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade currentTarget para acessar o objeto na lista de exibição que está processando o evento no momento. |
Elementos da API relacionados
networkChange | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.NETWORK_CHANGE| Versões de runtime: | AIR 1.0 |
Despachado quando uma nova conexão de rede se torna disponível ou uma conexão de rede existente está perdida.
Um evento networkChange não significa necessariamente que o computador host ficou on-line ou off-line; ele pode simplesmente estar transitando de um tipo de conexão para outro. Os aplicativos podem usar esse evento para ajudar a otimizar a tarefa de monitoramento da disponibilidade de recursos remotos. O despacho de um evento networkChange é, geralmente, um bom momento para verificar a disponibilidade de qualquer recurso remoto.
Observações:
- Pode haver um breve atraso entre uma mudança de rede e a entrega desse evento.
- No Android, o objeto NativeApplication pode despachar mais de um evento networkChange para cada alteração em uma conexão de rede.
Event.NETWORK_CHANGE define o valor da propriedade type de um objeto de evento networkChange.
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 NativeApplication. |
suspend | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.SUSPEND| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3.3 |
Despachado quando o aplicativo está a ponto de ser suspenso pelo sistema operacional.
A constanteEvent.SUSPEND define o valor da propriedade type de um objeto de evento suspend. Este evento é enviado apenas no AIR iOS.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
currentTarget | O objeto NativeApplication. |
target | O objeto NativeApplication. |
userIdle | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.USER_IDLE| Versões de runtime: | AIR 1.0 |
Despachado quando o usuário ficou ocioso.
Especifique o período de tempo no qual um usuário pode ficar ocioso antes que este evento seja despachado usando a propriedade idleThreshold. A quantia de tempo em que o usuário esteve ocioso pode ser determinado pela propriedade timeSinceLastUserInput.
Nota: este evento não é despachado em dispositivos móveis nem em dispositivos AIR for TV.
A constanteEvent.USER_IDLE define o valor da propriedade type de um objeto de evento userIdle.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
target | O objeto NativeApplication. |
Elementos da API relacionados
userPresent | Evento |
flash.events.Eventpropriedade Event.type =
flash.events.Event.USER_PRESENT| Versões de runtime: | AIR 1.0 |
Despachado quando o sistema operacional detecta a atividade do mouse ou do teclado após um período de ociosidade.
Nota: este evento não é despachado em dispositivos móveis nem em dispositivos AIR for TV.
O período em que é considerado ocioso é configurável com a propriedade idleThreshold. A quantia de tempo em que o usuário esteve ocioso pode ser determinado pela propriedade timeSinceLastUserInput.
Event.USER_PRESENT define o valor da propriedade type de um objeto de evento userPresent.
Esse evento tem as seguintes propriedades:
| Propriedade | Valor |
|---|---|
bubbles | false |
cancelable | false; não há comportamento padrão a ser cancelado. |
target | O objeto NativeApplication. |
Elementos da API relacionados
Wed Jun 13 2018, 11:10 AM Z