NativeApplication  - AS3

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.

O conteúdo do arquivo do descritor do aplicativo para esse aplicativo AIR.

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);

O ID desse aplicativo.

O valor desse ID é definido no arquivo do descritor do aplicativo.

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.

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.

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.

Elementos da API relacionados

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).

Elementos da API relacionados

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).

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.

Elementos da API relacionados

A ocorrência singleton do objeto NativeApplication.

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.

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.

O nível do pacote do tempo de execução que hospeda este aplicativo.

O número de versão do tempo de execução que hospeda este aplicativo.

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.

Elementos da API relacionados

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.

Elementos da API relacionados

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).

Elementos da API relacionados

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).

Elementos da API relacionados

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.

Elementos da API relacionados

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).

Elementos da API relacionados

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.

Elementos da API relacionados

A hora, em segundos, desde a última entrada do usuário.

Elementos da API relacionados

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

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

function(evt:Event):void

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.

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.

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.

Envia um evento para o fluxo de eventos. O destino de evento é o objeto EventDispatcher no qual o método dispatchEvent() é chamado.

Parâmetros

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

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

Elementos da API relacionados

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

Elementos da API relacionados

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.

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

Elementos da API relacionados

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

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.

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

Elementos da API relacionados

Despachado quando esse aplicativo se torna o aplicativo ativo da área de trabalho.

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:

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>

Despachado quando o foco da área de trabalho é alternado para um aplicativo diferente.

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:

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().

Esse evento tem as seguintes propriedades:

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.

O objeto InvokeEvent tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

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.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

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.

Esse evento tem as seguintes propriedades:

Despachado quando o aplicativo está a ponto de ser suspenso pelo sistema operacional.

Esse evento tem as seguintes propriedades:

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.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados

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.

Esse evento tem as seguintes propriedades:

Elementos da API relacionados