| Pacote | flash.events |
| Classe | public class InvokeEvent |
| Herança | InvokeEvent  Event Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
invoke quando o aplicativo é invocado.
O objeto NativeApplication sempre despacha um evento invoke quando é aberto um aplicativo, mas o evento pode ser despachado em outros momentos também. Por exemplo, um aplicativo em execução despacha um InvokeEvent adicional quando o usuário ativa um arquivo associado ao aplicativo.
Pode ser iniciada apenas uma única ocorrência de um aplicativo específico. As tentativas subsequentes de abrir o aplicativo vão resultar em um novo evento invoke despachado pelo objeto NativeApplication da ocorrência em execução. É de responsabilidade do aplicativo manipular este evento e tomar a ação apropriada, como abrir uma nova janela do aplicativo para exibir os dados em um arquivo.
Os objetos InvokeEvent são despachados pelo objeto NativeApplication (NativeApplication.nativeApplication). Para receber eventos invoke, chame o método addEventListener() do objeto NativeApplication. Quando um ouvinte de evento registra um evento invoke, ele também vai receber todos os eventos invoke que ocorreram antes do registro. Esses eventos anteriores são despachados depois que a chamada a addEventListener() retorna, mas não necessariamente antes de um novo evento invoke, que pode ser despachado depois do registro. Por isso, você não deve confiar na ordem de despacho.
Elementos da API relacionados
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
| arguments : Array [somente leitura]
A matriz dos argumentos da string transmitida durante esta invocação. | InvokeEvent | ||
 | bubbles : Boolean [somente leitura]
Indica se um evento é do tipo bubbling. | Event | |
| cancelable : Boolean [somente leitura]
Indica se o comportamento associado ao evento pode ser impedido. | Event | |
| constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| currentDirectory : File [somente leitura]
O diretório que deverá ser usado para resolver os caminhos relativos na matriz de argumentos. | InvokeEvent | ||
| currentTarget : Object [somente leitura]
O objeto que está processando ativamente o objeto Event com um ouvinte de evento. | Event | |
| eventPhase : uint [somente leitura]
A fase atual no fluxo de eventos. | Event | |
| reason : String [somente leitura]
O motivo deste InvokeEvent. | InvokeEvent | ||
| target : Object [somente leitura]
O destino de evento. | Event | |
| type : String [somente leitura]
O tipo de evento. | Event | |
| Método | Definido por | ||
|---|---|---|---|
InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")
A função de construtor da classe InvokeEvent. | InvokeEvent | ||
[substituir]
Cria uma cópia nova deste evento. | InvokeEvent | ||
|
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Verifica se o método preventDefault() foi chamado no evento. | Event | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | |
|
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
|
Retorna uma string que contém todas as propriedades do objeto Event. | Event | |
|
Retorna o valor primitivo do objeto especificado. | Object | |
| Constante | Definido por | ||
|---|---|---|---|
| INVOKE : String = "invoke" [estático]
A constante InvokeEvent.INVOKE define o valor da propriedade de tipo de um objeto InvokeEvent. | InvokeEvent | ||
arguments | propriedade |
arguments:Array [somente leitura] | Versões de runtime: | AIR 1.0 |
A matriz dos argumentos da string transmitida durante esta invocação. Se esta for uma invocação da linha de comando, a matriz contém os argumentos da linha de comando (excluindo o nome de processo).
Nas plataformas móveis, essa propriedade contém a gama de opções com as quais o aplicativo foi iniciado, não os argumentos da linha de comando. Além disso, em plataformas móveis, quando reason for InvokeEventReason.OPEN_URL, o conteúdo da Matriz de argumentos varia, com a seguir:
- Outro aplicativo ou navegador invoca o aplicativo com um URL personalizado (iOS e Android):
arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]ID do aplicativo de origem ID da ação InvokeEvent.arguments[2]null NA - O sistema invoca o aplicativo para abrir um tipo de arquivo associado (iOS e Android):
arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]null ID da ação InvokeEvent.arguments[2]null NA - Outro aplicativo invoca o aplicativo usando o controlador de interação de documento (somente iOS):
arguments iOS InvokeEvent.arguments.length3 InvokeEvent.arguments[0]url InvokeEvent.arguments[1]ID do aplicativo de origem InvokeEvent.arguments[2]annotation
Observação: quando forem selecionados e abertos vários arquivos no Mac® OS X, o AIR despacha um evento único invoke contendo os nomes de todos os arquivos selecionados na matriz arguments. No Windows®, no entanto, o AIR despacha um evento invoke separado para cada arquivo selecionado contendo apenas aquele nome de arquivo na matriz arguments.
Implementação
public function get arguments():Array currentDirectory | propriedade |
currentDirectory:File [somente leitura] | Versões de runtime: | AIR 1.0 |
O diretório que deverá ser usado para resolver os caminhos relativos na matriz arguments.
Se um aplicativo for iniciado a partir de uma linha de comando, geralmente essa propriedade é definida para o diretório de trabalho atual do shell da linha de comando a partir da qual o aplicativo foi iniciado. Se o aplicativo foi lançado a partir do shell da GUI, geralmente essa é a raiz do sistema de arquivos.
Implementação
public function get currentDirectory():File reason | propriedade |
reason:String [somente leitura] | Versões de runtime: | AIR 1.5.1 |
O motivo deste InvokeEvent. Esta propriedade indica se o aplicativo foi iniciado manualmente pelo usuário ou automaticamente no login. Os valores possíveis são enumerados como constantes na classe InvokeEventReason:
| Constante InvokeEventReason | Significado |
|---|---|
LOGIN | Iniciado automaticamente no login. |
NOTIFICATION | Inicializado em resposta a uma notificação (somente iOS) |
OPEN_URL | Inicializado porque o aplicativo foi invocado por outro aplicativo. |
STANDARD | Lançado por qualquer outra razão. |
Observação: nas plataformas móveis, a propriedade reason nunca está definida como LOGIN.
Implementação
public function get reason():StringElementos da API relacionados
InvokeEvent | () | Construtor |
public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
A função de construtor da classe InvokeEvent.
Parâmetrostype:String — O tipo do evento, acessível como Event.type.
| |
bubbles:Boolean (default = false)false para um objeto InvokeEvent.
| |
cancelable:Boolean (default = false)false para um objeto InvokeEvent.
| |
dir:File (default = null)arguments.
| |
argv:Array (default = null) | |
reason:String (default = "standard")InvokeEventReason.LOGIN, InvokeEventReason.STANDARD, InvokeEventReason.OPEN_URL ou InvokeEventReason.NOTIFICATION. (Esse parâmetro está disponível a partir da versão 1.5.1 do AIR. OPEN_URL e NOTIFICATION estão disponíveis a partir da versão 3.5. do AIR)
|
Elementos da API relacionados
clone | () | método |
INVOKE | Constante |
public static const INVOKE:String = "invoke"| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 1.0 |
A constante 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. |
Elementos da API relacionados
Wed Jun 13 2018, 11:10 AM Z