| Paquete | flash.events |
| Clase | public class InvokeEvent |
| Herencia | InvokeEvent  Event Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
invoke cuando se invoca la aplicación.
El objeto NativeApplication siempre distribuye un evento invoke cuando se inicia una aplicación, pero este evento también se puede distribuir en otros contextos. Por ejemplo, una aplicación en ejecución distribuye un evento invoke adicional cuando el usuario activa un archivo asociado a la aplicación.
Sólo es posible iniciar una instancia de cada aplicación. Los siguientes intentos de iniciar la aplicación tendrán como resultado un nuevo evento invoke distribuido por el objeto NativeApplication de la instancia en ejecución. Es responsabilidad de la aplicación gestionar el evento y realizar la acción adecuada, por ejemplo, abrir una nueva ventana de la aplicación para mostrar los datos de un archivo.
Los objetos InvokeEvent se distribuyen mediante el objeto NativeApplication (NativeApplication.nativeApplication). Para recibir eventos invoke, llame al método addEventListener() del objeto NativeApplication. Si un detector de eventos registra un evento invoke, también recibe todos los eventos invoke producidos antes del registro. Los eventos anteriores se distribuyen cuando se devuelve la llamada a addEventListener(), pero no necesariamente antes de un nuevo evento invoke que pueda distribuirse tras el registro. Por ello, no debe basarse en el orden de distribución.
Elementos de API relacionados
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
| arguments : Array [solo lectura]
Conjunto de argumentos de cadena transferidos durante la invocación. | InvokeEvent | ||
 | bubbles : Boolean [solo lectura]
Indica si un evento es un evento de propagación. | Event | |
| cancelable : Boolean [solo lectura]
Indica si se puede evitar el comportamiento asociado al evento. | Event | |
| constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| currentDirectory : File [solo lectura]
Directorio que debe utilizarse para resolver rutas relativas en el conjunto arguments. | InvokeEvent | ||
| currentTarget : Object [solo lectura]
Objeto que procesa de forma activa el objeto de evento con un detector de eventos. | Event | |
| eventPhase : uint [solo lectura]
La fase actual en el flujo del evento. | Event | |
| reason : String [solo lectura]
La razón de este evento InvokeEvent. | InvokeEvent | ||
| target : Object [solo lectura]
El destino del evento. | Event | |
| type : String [solo lectura]
El 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")
La función constructora de la clase InvokeEvent. | InvokeEvent | ||
[override]
Crea una nueva copia de este evento. | InvokeEvent | ||
|
Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0. | Event | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Comprueba si se ha llamado a preventDefault() en el evento. | Event | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
|
Cancela el comportamiento predeterminado de un evento si es posible cancelarlo. | Event | |
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento. | Event | |
|
Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual. | Event | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve una cadena que contiene todas las propiedades del objeto de evento. | Event | |
|
Devuelve el valor simple del objeto especificado. | Object | |
| Constante | Definido por | ||
|---|---|---|---|
| INVOKE : String = "invoke" [estática]
La constante InvokeEvent.INVOKE define el valor de la propiedad type de un objeto InvokeEvent. | InvokeEvent | ||
arguments | propiedad |
arguments:Array [solo lectura] | Versiones de motor de ejecución: | AIR 1.0 |
Conjunto de argumentos de cadena transferidos durante la invocación. Si es una invocación desde la línea de comandos, el conjunto contendrá los argumentos de la línea de comandos sin incluir el nombre del proceso.
En plataformas móviles, esta propiedad contiene el conjunto de opciones de la aplicación tal y como se lanzó, no los argumentos de la línea de comandos. Además, en plataformas móviles, cuando reason es InvokeEventReason.OPEN_URL, el contenido del conjunto de argumentos varía del modo siguiente:
- Otra aplicación o navegador invoca la aplicación con una dirección URL personalizada (iOS y Android):
arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]source app id action id InvokeEvent.arguments[2]null ND - El sistema invoca la aplicación para abrir un tipo de archivo asociado (iOS y Android):
arguments iOS Android InvokeEvent.arguments.length3 2 InvokeEvent.arguments[0]url url InvokeEvent.arguments[1]null action id InvokeEvent.arguments[2]null ND - Otra aplicación invoca la aplicación con un controlador de interacción de documentos (solo iOS):
arguments iOS InvokeEvent.arguments.length3 InvokeEvent.arguments[0]url InvokeEvent.arguments[1]source app id InvokeEvent.arguments[2]annotation
Nota: si se seleccionan y se abren varios archivos en Mac® OS X, AIR distribuye un único evento invoke con los nombres de todos los archivos seleccionados en el conjunto arguments. En Windows ® y en Linux, sin embargo, AIR distribuye un evento invoke independiente para cada archivo seleccionado (contiene únicamente el archivo del conjunto arguments).
Implementación
public function get arguments():Array currentDirectory | propiedad |
currentDirectory:File [solo lectura] | Versiones de motor de ejecución: | AIR 1.0 |
Directorio que debe utilizarse para resolver rutas relativas en el conjunto arguments.
Si una aplicación se inicia desde la línea de comandos, esta propiedad suele establecerse en el directorio de trabajo del shell de la línea de comandos desde el que se inició la aplicación. Si una aplicación se inicia desde el shell de la interfaz gráfica de usuario, suele establecerse en la raíz del sistema de archivos.
Implementación
public function get currentDirectory():File reason | propiedad |
reason:String [solo lectura] | Versiones de motor de ejecución: | AIR 1.5.1 |
La razón de este evento InvokeEvent. Esta propiedad indica si la aplicación la inició el usuario manualmente o si se realizó automáticamente durante la conexión. Los valores válidos se enumeran como constantes de la clase InvokeEventReason:
| Constante InvokeEventReason | Significado |
|---|---|
LOGIN | Iniciada automáticamente en la conexión. |
NOTIFICATION | Se inicia como respuesta a una notificación (solo iOS). |
OPEN_URL | Se inicia porque la aplicación ha sido invocada por otra aplicación. |
STANDARD | Se inicia por cualquier otro motivo. |
Nota: en plataformas móviles, la propiedad reason nunca se establece en LOGIN.
Implementación
public function get reason():StringElementos de API relacionados
InvokeEvent | () | Información sobre |
public function InvokeEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, dir:File = null, argv:Array = null, reason:String = "standard")| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
La función constructora de la clase InvokeEvent.
Parámetrostype:String — El tipo de evento, al que se puede acceder como Event.type.
| |
bubbles:Boolean (default = false)falseen un objeto InvokeEvent.
| |
cancelable:Boolean (default = false)falseen un objeto InvokeEvent.
| |
dir:File (default = null)arguments.
| |
argv:Array (default = null) | |
reason:String (default = "standard")InvokeEventReason.LOGIN, InvokeEventReason.STANDARD, InvokeEventReason.OPEN_URL o InvokeEventReason.NOTIFICATION. (Este parámetro está disponible a partir de AIR 1.5.1. OPEN_URL y NOTIFICATION están disponibles a partir de AIR 3.5.)
|
Elementos de API relacionados
clone | () | método |
INVOKE | Constante |
public static const INVOKE:String = "invoke"| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
La constante InvokeEvent.INVOKE define el valor de la propiedad type de un objeto InvokeEvent.
El objeto del evento InvokeEvent tiene las siguientes propiedades:
| Propiedades | Valores |
|---|---|
arguments | Conjunto de argumentos de cadena transferidos durante la invocación. |
currentDirectory | un objeto File que representa el directorio que debe utilizarse para resolver rutas relativas en el conjunto arguments. |
reason | Un código que indica si el evento invoke se ha distribuido porque la aplicación se inició automáticamente en el inicio de sesión (InvokeEventReason.LOGIN), se inició como respuesta a una notificación remota (InvokeEventReason.NOTIFICATION - solo iOS), porque la aplicación se invocó a través de otra aplicación (InvokeEventReason.OPEN_URL) o por otro motivo (InvokeEventReason.STANDARD). Disponible a partir de AIR versión 1.5.1. |
bubbles | false. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Indica el objeto activo que procesa en el objeto InvokeEvent con un detector de eventos. |
target | Siempre es el objeto NativeApplication. |
Elementos de API relacionados
Tue Jun 12 2018, 02:12 PM Z