| Paquete | flash.desktop |
| Clase | public final class NativeApplication |
| Herencia | NativeApplication  EventDispatcher Object |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
La clase NativeApplication proporciona información de la aplicación, funciones de toda la aplicación y distribuye enventos en el nivel de la aplicación.
El objeto NativeApplication es un objeto simple creado automáticamente en el inicio. Obtiene la instancia de NativeApplication de una aplicación con propiedad estática NativeApplication.nativeApplication.
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| Propiedad | Definido por | ||
|---|---|---|---|
| activeWindow : NativeWindow [solo lectura]
La ventana de la aplicación activa. | NativeApplication | ||
| applicationDescriptor : XML [solo lectura]
Contenido del archivo descriptor de la aplicación de esta aplicación de AIR. | NativeApplication | ||
| applicationID : String [solo lectura]
ID de aplicación de esta aplicación. | NativeApplication | ||
| autoExit : Boolean
Especifica si la aplicación debe cerrarse automáticamente cuando se hayan cerrado todas las ventanas. | NativeApplication | ||
 | constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| executeInBackground : Boolean
Especifica si la aplicación se ejecutará en segundo plano o no. | NativeApplication | ||
| icon : InteractiveIcon [solo lectura]
Icono de la aplicación. | NativeApplication | ||
| idleThreshold : int
Número de segundos que deben transcurrir sin entrada del usuario antes de que se distribuya un evento userIdle. | NativeApplication | ||
| isCompiledAOT : Boolean [solo lectura]
Especifica si la aplicación está compilada o se interpreta correctamente para la plataforma que desee. | NativeApplication | ||
| menu : NativeMenu
El menú de la aplicación. | NativeApplication | ||
| nativeApplication : NativeApplication [estática] [solo lectura]
La instancia simple del objeto NativeApplication. | NativeApplication | ||
| openedWindows : Array [solo lectura]
Cualquier conjunto que contenga todas las ventanas nativas abiertas de la aplicación. | NativeApplication | ||
| publisherID : String [solo lectura]
ID de editor de esta aplicación. | NativeApplication | ||
| runtimePatchLevel : uint [solo lectura]
Nivel de parche del motor de ejecución que aloja esta aplicación. | NativeApplication | ||
| runtimeVersion : String [solo lectura]
Número de versión del motor de ejecución que aloja esta aplicación. | NativeApplication | ||
| startAtLogin : Boolean
Indica si la aplicación se inicia automáticamente cada vez que el usuario inicia sesión. | NativeApplication | ||
| supportsDefaultApplication : Boolean [estática] [solo lectura]
Indica si setAsDefaultApplication(), removeAsDefaultApplication() y isSetAsDefaultApplication() son compatibles en la plataforma actual. | NativeApplication | ||
| supportsDockIcon : Boolean [estática] [solo lectura]
Indica si AIR admite iconos de aplicación acoplados en el sistema operativo actual. | NativeApplication | ||
| supportsMenu : Boolean [estática] [solo lectura]
Indica si el sistema operativo actual admite una barra de menú de aplicación global. | NativeApplication | ||
| supportsStartAtLogin : Boolean [estática] [solo lectura]
Indica si startAtLogin se admite en la plataforma actual. | NativeApplication | ||
| supportsSystemTrayIcon : Boolean [estática] [solo lectura]
Especifica si AIR admite iconos de bandeja del sistema de la aplicación en el sistema operativo actual. | NativeApplication | ||
| systemIdleMode : String
Permite que las aplicaciones impidan que la interfaz del usuario entre en modo de “inactividad”. | NativeApplication | ||
| timeSinceLastUserInput : int [solo lectura]
El tiempo, en segundos, desde la última entrada realizada por el usuario. | NativeApplication | ||
| Método | Definido por | ||
|---|---|---|---|
Activa esta aplicación. | NativeApplication | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void [override]
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | NativeApplication | ||
Invoca un comando delete interno en el objeto de visualización seleccionado. | NativeApplication | ||
Invoca un comando copy interno en el objeto de visualización seleccionado. | NativeApplication | ||
Invoca un comando cut interno en el objeto de visualización seleccionado. | NativeApplication | ||
[override]
Distribuye un evento en el flujo del evento. | NativeApplication | ||
Termina esta aplicación. | NativeApplication | ||
Obtiene la aplicación predeterminada para abrir los archivos de la extensión especificada. | NativeApplication | ||
|
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | |
Indica si la aplicación es la aplicación predeterminada actual para abrir archivos de la extensión especificada. | NativeApplication | ||
Invoca un comando paste interno en el objeto de visualización seleccionado. | NativeApplication | ||
|
Indica si existe la propiedad especificada y si es enumerable. | Object | |
Elimina la aplicación como predeterminada para abrir archivos de la extensión especificada. | NativeApplication | ||
[override]
Elimina un detector del objeto EventDispatcher. | NativeApplication | ||
Invoca un comando selectAll interno en el objeto de visualización seleccionado. | NativeApplication | ||
Define la aplicación como aplicación predeterminada para abrir archivos de la extensión especificada. | NativeApplication | ||
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
|
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher | |
| Evento | Resumen | Definido por | ||
|---|---|---|---|---|
| Se distribuye cuando esta aplicación pasa a ser la aplicación de escritorio activa. | NativeApplication | |||
| Se distribuye cuando un archivo SWF ejecutado en el navegador del usuario invoca una aplicación. | NativeApplication | |||
| Se distribuye cuando la selección del escritorio pasa a otra aplicación. | NativeApplication | |||
| Se distribuye cuando se inicia la secuencia de cierre de la aplicación. | NativeApplication | |||
| Se distribuye cuando se invoca una aplicación. | NativeApplication | |||
| Se distribuye cuando el usuario pulsa una tecla. | NativeApplication | |||
| Se distribuye cuando el usuario suelta una tecla. | NativeApplication | |||
| Se distribuye si una nueva conexión de red pasa a estar disponible o si se pierde una existente. | NativeApplication | |||
| Se distribuye cuando la aplicación se va a ser suspendida por el sistema operativo. | NativeApplication | |||
| Se distribuye cuando el usuario ha estado inactivo. | NativeApplication | |||
| Se distribuye cuando el sistema operativo detecta el movimiento del cursor o del ratón tras un periodo de inactividad. | NativeApplication | |||
activeWindow | propiedad |
activeWindow:NativeWindow [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
La ventana de la aplicación activa.
Si la ventana activa en el escritorio activo no pertenece a esta aplicación, o si no hay ninguna ventana activa, activeWindow es null.
Esta propiedad no se admite en plataformas que no admiten la clase NativeWindow.
Implementación
public function get activeWindow():NativeWindow applicationDescriptor | propiedad |
applicationDescriptor:XML [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Contenido del archivo descriptor de la aplicación de esta aplicación de AIR.
Implementación
public function get applicationDescriptor():XMLEjemplo ( Cómo utilizar este ejemplo )
copyright y version del archivo descriptor de la aplicación. Tenga en cuenta que debe utilizar el espacio de nombres definido en el código XML del descriptor de la aplicación.
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 | propiedad |
autoExit | propiedad |
autoExit:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Especifica si la aplicación debe cerrarse automáticamente cuando se hayan cerrado todas las ventanas.
Si autoExit es true (valor predeterminado), la aplicación se cierra cuando se hayan cerrado todas las ventanas. Se distribuyen eventos exiting y exit. Si autoExit es false, se debe llamar a NativeApplication.nativeApplication.exit() para cerrar la aplicación.
Esta propiedad no se admite en plataformas que no admiten la clase NativeWindow.
Implementación
public function get autoExit():Boolean public function set autoExit(value:Boolean):void executeInBackground | propiedad |
executeInBackground:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3.3 |
Especifica si la aplicación se ejecutará en segundo plano o no.
Cuando executeInBackground es false, que es el valor predeterminado, la aplicación permanece en estado de suspensión cuando pasa a segundo plano. Cuando executeInBackground es true, la aplicación se puede ejecutar en segundo plano.
Nota: con SWF versión 21 y anteriores, AIR no admite la ejecución de iOS y Android en segundo plano cuando se ha establecido renderMode direct. Debido a esta restricción, las aplicaciones basadas en Stage3D no pueden ejecutar tareas en segundo plano como la reproducción de audio, actualizaciones de ubicación, carga o descarga de red, etc. iOS no permite llamadas OpenGLES o de representación en segundo plano. El sistema iOS cierra las aplicaciones que intentan hacer llamadas OpenGL en segundo plano. Android no restringe ni las llamadas OpenGLES ni otras tareas de aplicaciones en segundo plano, como la reproducción de audio. Con SWF versión 22 y posteriores, las aplicaciones de AIR móviles pueden ejecutarse en un segundo plano cuando se ha establecido renderMode direct. El tiempo de ejecución de AIR iOS produce un error de ActionScript (3768: la API Stage3D no se puede usar durante la ejecución en segundo plano) si las llamadas OpenGLES se realizan en segundo plano. Sin embargo, no hay errores en Android porque sus aplicaciones nativas pueden realizar llamadas OpenGLES en segundo plano. Para el uso óptimo de recursos móviles, no realice llamadas de procesamiento cuando una aplicación se está ejecutando en segundo plano.
Esta propiedad es compatible con AIR iOS y Android.
Implementación
public function get executeInBackground():Boolean public function set executeInBackground(value:Boolean):void icon | propiedad |
icon:InteractiveIcon [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Icono de la aplicación.
Utilice NativeApplication.supportsDockIcon y NativeApplication.supportsSystemTrayIcon para determinar la clase icon. El tipo será una de las subclases de InteractiveIcon. En Mac® OS X, NativeApplication.icon es un objeto de tipo DockIcon. En Windows®, NativeApplication.icon es un objeto de tipo SystemTrayIcon. Cuando un icono de aplicación no es compatible, NativeApplication.supportsDockIcon y NativeApplication.supportsSystemTrayIcon son false y la propiedad icon es null.
El objeto icon se crea automáticamente, pero no se inicializa con datos de imagen. En algunos sistemas operativos, como Mac OS X, se incluye una imagen predeterminada. En otros, como Windows, el icono no se muestra a no ser que tenga datos de imagen asignados. Para asignar una imagen al icono, establezca la propiedad icon.bitmaps con un conjunto que contenga al menos un objeto BitmapData. Si el conjunto contiene más de un objeto BitmapData, el sistema operativo elige la imagen con tamaño más parecido a las dimensiones de visualización del icono, modificando su tamaño si es necesario.
Implementación
public function get icon():InteractiveIconElementos de API relacionados
idleThreshold | propiedad |
idleThreshold:int| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Número de segundos que deben transcurrir sin entrada del usuario antes de que se distribuya un evento userIdle.
De forma predeterminada, el umbral de inactividad es 300 segundos (5 minutos). El rango aceptable de valores oscila entre 5 (5 segundos) y 86.400 (1 día), ambos incluidos.
Implementación
public function get idleThreshold():int public function set idleThreshold(value:int):voidEmite
ArgumentError — Si se intenta establecer la propiedad en un valor no válido. El rango aceptable de valores oscila entre 5 (5 segundos) y 86.400 (1 día), ambos incluidos.
|
Elementos de API relacionados
isCompiledAOT | propiedad |
isCompiledAOT:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 25.0 |
Especifica si la aplicación está compilada o se interpreta correctamente para la plataforma que desee. Esta API devuelve (true) solo para destinos de iOS (ipa-app-store, ipa-test, ipa-debug, ipa-ad-hoc). Para otras plataformas de AIR, devuelve (false).
Implementación
public function get isCompiledAOT():Boolean menu | propiedad |
menu:NativeMenu| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
El menú de la aplicación.
Los menús de aplicación se admiten si NativeApplication.supportsMenu es true. No todos los sistemas operativos admiten menús de aplicación. Por ejemplo, los menús de aplicación se admite en Mac OS X, pero no en Windows o en Linux. Se permite asignar un objeto NativeMenu a esta propiedad cuando NativeApplication.supportsMenu es false, pero no produce ningún efecto. Asegúrese de utilizar la propiedad NativeApplication.supportsMenu para determinar si el sistema operativo admite menús de aplicación. El uso de otros medios (como Capabilities.os) para determinar la compatibilidad puede producir errores de programación (si no se tienen en cuenta determinados sistemas operativos de destino).
Compatibilidad con perfil de AIR: esta característica no se admite en dispositivos móviles o dispositivos de AIR para TV. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
Nota: en Mac OS X, la propiedad menu hace referencia al menú de aplicación predeterminado proporcionado por el sistema operativo. Es posible modificar la estructura de menús existente. Para ello, se pueden añadir y eliminar opciones y submenús, o añadir detectores de eventos. También puede reemplazar los menús predeterminados por completo si asigna un nuevo objeto NativeMenu a esta propiedad menu.
Implementación
public function get menu():NativeMenu public function set menu(value:NativeMenu):voidElementos de API relacionados
nativeApplication | propiedad |
nativeApplication:NativeApplication [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
La instancia simple del objeto NativeApplication.
Implementación
public static function get nativeApplication():NativeApplicationEmite
Error — Si se accede mediante contenido situado fuera del entorno limitado de seguridad de la aplicación.
|
openedWindows | propiedad |
openedWindows:Array [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Cualquier conjunto que contenga todas las ventanas nativas abiertas de la aplicación.
Esta propiedad no se admite en plataformas que no admiten la clase NativeWindow.
Implementación
public function get openedWindows():Array publisherID | propiedad |
publisherID:String [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
ID de editor de esta aplicación.
El valor de este ID se establece en el archivo publisherid de la aplicación, que se genera durante la instalación de la cadena de certificado utilizada para firmar la aplicación.
Implementación
public function get publisherID():String runtimePatchLevel | propiedad |
runtimeVersion | propiedad |
startAtLogin | propiedad |
startAtLogin:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Indica si la aplicación se inicia automáticamente cada vez que el usuario inicia sesión.
Compatibilidad con perfil de AIR: esta característica se admite en todos los sistemas operativos de escritorio, pero no en dispositivos móviles o en dispositivos de AIR para TV. Puede comprobar la compatibilidad en tiempo de ejecución mediante la propiedad NativeApplication.supportsStartAtLogin. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
La propiedad startAtLogin refleja el estado del mecanismo definido por el sistema operativo para designar que una aplicación debe iniciarse automáticamente cuando un usuario inicia sesión. El usuario puede cambiar el estado manualmente desde la interfaz de usuario del sistema operativo. Esta propiedad refleja el estado actual, haya cambiado o no este estado por influencia de la aplicación de AIR o del sistema operativo.
Implementación
public function get startAtLogin():Boolean public function set startAtLogin(value:Boolean):voidEmite
IllegalOperationError — En Windows cuando otra aplicación con el mismo nombre (pero con su archivo ejecutable en distintas rutas) ya está definida para iniciarse cuando el usuario inicia sesión.
| |
IllegalOperationError — Si esta aplicación no está instalada, que puede ocurrir si se ha iniciado con AIR Debug Launcher (ADL).
|
Elementos de API relacionados
supportsDefaultApplication | propiedad |
supportsDefaultApplication:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2 |
Indica si setAsDefaultApplication(), removeAsDefaultApplication() y isSetAsDefaultApplication() son compatibles en la plataforma actual.
Si es true, los métodos anteriores funcionan como se ha descrito. Si es false, setAsDefaultApplication() y removeDefaultApplication() no hacen nada y isSetAsDefaultApplication() devuelve false.
Implementación
public static function get supportsDefaultApplication():BooleanElementos de API relacionados
supportsDockIcon | propiedad |
supportsDockIcon:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Indica si AIR admite iconos de aplicación acoplados en el sistema operativo actual.
Si es true, la propiedad NativeApplication.icon es de tipo DockIcon.
La interfaz de usuario de Mac OS X ofrece una barra inferior (Dock) en la que se acoplan los iconos de las aplicaciones en ejecución o más utilizadas.
Asegúrese de utilizar la propiedad NativeApplication.supportsDockIcon para determinar si el sistema operativo admite iconos de aplicaciones acoplados. El uso de otros medios (como Capabilities.os) para determinar la compatibilidad puede producir errores de programación (si no se tienen en cuenta determinados sistemas operativos de destino).
Implementación
public static function get supportsDockIcon():BooleanElementos de API relacionados
supportsMenu | propiedad |
supportsMenu:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Indica si el sistema operativo actual admite una barra de menú de aplicación global.
Si es true, se puede utilizar la propiedad NativeApplication.menu para definir (u obtener acceso) un menú de aplicación nativo.
Asegúrese de utilizar la propiedad NativeApplication.supportsMenu para determinar si el sistema operativo admite la barra de menús de aplicaciones. El uso de otros medios (como Capabilities.os) para determinar la compatibilidad puede producir errores de programación (si no se tienen en cuenta determinados sistemas operativos de destino).
Implementación
public static function get supportsMenu():BooleanElementos de API relacionados
supportsStartAtLogin | propiedad |
supportsStartAtLogin:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2 |
Indica si startAtLogin se admite en la plataforma actual.
Si es true, startAtLogin funciona como se ha descrito. Si es false, startAtLogin no tiene ningún efecto.
Implementación
public static function get supportsStartAtLogin():BooleanElementos de API relacionados
supportsSystemTrayIcon | propiedad |
supportsSystemTrayIcon:Boolean [solo lectura] | Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Especifica si AIR admite iconos de bandeja del sistema de la aplicación en el sistema operativo actual.
Si es true, la propiedad NativeApplication.icon es de tipo SystemTrayIcon.
Las interfaz de usuario de Windows ofrece la “bandeja del sistema” en la zona de la barra de tareas, cuyo nombre oficial es Área de notificaciones, en la que se muestran los iconos de las aplicaciones. No se muestra ningún icono predeterminado. Debe establecer el conjunto bitmaps del objeto icon para mostrar un icono.
Asegúrese de utilizar la propiedad NativeApplication.supportsSystemTrayIcon para determinar si el sistema operativo admite iconos de bandeja del sistema. El uso de otros medios (como Capabilities.os) para determinar la compatibilidad puede producir errores de programación (si no se tienen en cuenta determinados sistemas operativos de destino).
Implementación
public static function get supportsSystemTrayIcon():BooleanElementos de API relacionados
systemIdleMode | propiedad |
systemIdleMode:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 2 |
Permite que las aplicaciones impidan que la interfaz del usuario entre en modo de “inactividad”.
Un valor de la clase SystemIdleMode que influye en el comportamiento del modo de inactividad del sistema del host. Esta propiedad sólo es eficaz para la aplicación con selección de entrada y sólo se puede acceder desde el contenido que se ejecuta en el entorno limitado de seguridad de la aplicación.
Compatibilidad con perfil de AIR: esta característica se admite en dispositivos móviles compatibles, pero no se admite en sistemas operativos de escritorio o dispositivos de AIR para TV. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
Implementación
public function get systemIdleMode():String public function set systemIdleMode(value:String):voidElementos de API relacionados
timeSinceLastUserInput | propiedad |
activate | () | método |
public function activate(window:NativeWindow = null):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Activa esta aplicación.
Este método no es compatible con plataformas que no admiten la clase NativeWindow.
En circunstancias concretas determinadas por el sistema operativo, este método no activa ninguna aplicación. La mayoría de los sistemas operativos limitan la capacidad de sus aplicaciones para autoactivarse para que no puedan impedir (accidentalmente o de forma malintencionada) que otros usuarios utilicen las aplicaciones.
Si el sistema operativo permite la activación, se activará la ventana especificada y se mostrará en primer plano, es decir, delante de las ventanas del resto de aplicaciones abiertas. (Si el parámetro window es null, se activa una ventana visible de esta aplicación.)
El método activate() no tiene ningún efecto si no hay ventanas visibles de la aplicación.
La operación de activación es sincrónica.
Parámetros
window:NativeWindow (default = null) |
Eventos
activate: — Se distribuye si cambia el estado de activación.
|
addEventListener | () | método |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void| Versiones de motor de ejecución: | AIR 1.0 |
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. Puede registrar detectores de eventos en todos los nodos de la lista de visualización para un tipo concreto de evento, fase y prioridad.
Una vez registrado correctamente un detector de eventos, no puede cambiar su prioridad mediante llamadas adicionales a addEventListener(). Para cambiar la prioridad de un detector, en primer lugar debe llamar a removeListener(). Seguidamente, puede volver a registrar el nuevo nivel de prioridad.
Recuerde que, una vez registrado el detector, las siguientes llamadas a addEventListener() con un valor type o useCapture distinto tendrán como resultado la creación de un registro independiente del detector. Por ejemplo, si registra primero un detector con useCapture definido como true, detectará únicamente durante la fase de captura. Si vuelve a llamar a addEventListener() con el mismo objeto detector, pero con useCapture definido como false, tendrá dos detectores independientes: uno que detecta durante la fase de captura y otro que lo hace durante las fases de destino y de propagación.
No es posible registrar un detector de eventos únicamente para la fase de destino o la fase de propagación. Dichas fases se acoplan durante el registro, ya que la propagación sólo se aplica a los ascendientes del nodo de destino.
Si ya no necesita ningún detector de eventos, elimínelo llamando a removeEventListener(); de lo contrario, podrían surgir problemas de memoria. Los detectores de eventos no se eliminan automáticamente de la memoria, ya que el recolector de datos innecesarios no elimina el detector siempre que el objeto distribuido exista (a no ser que el parámetro useWeakReference se establezca en true).
Al copiar una instancia EventDispatcher no se copian los detectores de eventos asociados. (Si el nodo recién creado necesita un detector de eventos, debe asociarlo después de crear el nodo.) Sin embargo, si mueve una instancia EventDispatcher, los detectores de eventos asociados se moverán también.
Si el detector de eventos se registra en un nodo mientras se procesa un evento en dicho nodo, el detector de eventos no se desencadenará durante la fase actual, aunque sí se desencadenará en una fase posterior del flujo del evento, por ejemplo, en la fase de propagación.
Si un detector de eventos se elimina de un nodo mientras se procesa un evento en dicho nodo, las acciones actual seguirán desencadenándolo. Una vez eliminado, el detector de eventos ya no se vuelve a invocar nunca más (a no ser que se registre de nuevo para otro proceso).
Parámetros
type:String — El tipo de evento.
| |
listener:Function — La función del detector que procesa el evento. Esta función debe aceptar un objeto de evento como parámetro único y no debe devolver ningún valor, tal como indica el siguiente ejemplo:
function(evt:Event):void La función puede tener cualquier nombre. | |
useCapture:Boolean (default = false)useCapture se define como true, el detector procesa el evento sólo durante la fase de captura y no en las fases de destino o propagación. Si useCapture es false, el detector procesa el evento sólo durante la fase de destino o de propagación. Para detectar el evento en las tres fases, llame dos veces a addEventListener, una con useCapture establecido en true y, después, otra con useCapture definido como false.
| |
priority:int (default = 0) | |
useWeakReference:Boolean (default = false)Las funciones de miembros de clase no están sujetas a la recolección de elementos no utilizados, por lo que |
clear | () | método |
public function clear():Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Invoca un comando delete interno en el objeto de visualización seleccionado.
Esta llamada a la función se omite si el objeto seleccionado no implementa el comando. Sólo se muestran objetos descendentes en las clases TextField o HTMLLoader que implementan actualmente este comando.
Nota: el comando clear() borra el texto seleccionado. Si no hay nada seleccionado, no se borra ningún texto.
Boolean — true.
|
copy | () | método |
public function copy():Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Invoca un comando copy interno en el objeto de visualización seleccionado.
Esta llamada a la función se omite si el componente no implementa el comando. Sólo se muestran objetos descendentes en las clases TextField o HTMLLoader que implementan actualmente este comando.
Valor devueltoBoolean |
cut | () | método |
public function cut():Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Invoca un comando cut interno en el objeto de visualización seleccionado.
Esta llamada a la función se omite si el componente no implementa el comando. Sólo se muestran objetos descendentes en las clases TextField o HTMLLoader que implementan actualmente estos comandos.
Valor devueltoBoolean — true.
|
dispatchEvent | () | método |
override public function dispatchEvent(event:Event):Boolean| Versiones de motor de ejecución: | AIR 1.0 |
Distribuye un evento en el flujo del evento. El destino del evento es el objeto EventDispatcher en el que se llama al método dispatchEvent().
Parámetros
event:Event — El objeto de evento distribuido en el flujo del evento. Si el evento está siendo redistribuido, se crea un clon del evento automáticamente. Una vez distribuido un evento, no es posible modificar su propiedad target, por lo que se debe crear una nueva copia del evento para que la redistribución funcione.
|
Boolean — Un valor true si el evento se distribuye correctamente. Un valor false indica un error o que se ha llamado a preventDefault() en el evento.
|
exit | () | método |
public function exit(errorCode:int = 0):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Termina esta aplicación.
Se devuelve la llamada al método exit(); la secuencia de cierre no se inicia hasta que ha finalizado el código en ejecución (por ejemplo, el controlador de eventos activo). Las operaciones asíncronas pendientes se cancelan y pueden completarse o no.
Tenga en cuenta que no se distribuye ningún evento exiting. Si la lógica de la aplicación requiere un evento exiting, llame a NativeApplication.nativeApplication.dispatchEvent() y transfiera un objeto Event de tipo exiting. Para todas las ventanas abiertas, los objetos NativeWindow distribuyen eventos closing y close. Llamar al método preventDefault() del objeto de evento closing impide que la aplicación se cierre.
Nota: este método no se admite en el sistema operativo iOS.
Parámetros
errorCode:int (default = 0) |
getDefaultApplication | () | método |
public function getDefaultApplication(extension:String):String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Obtiene la aplicación predeterminada para abrir los archivos de la extensión especificada.
Nota: este método sólo puede utilizarse con tipos de archivo declarados en la declaración fileTypes del descriptor de la aplicación.
Este método no es aplicable para dispositivos de AIR para TV. Si se llama con un tipo de archivo declarado en el archivo descriptor de la aplicación, devuelve null.
Parámetros
extension:String — Objeto String que contiene la extensión del tipo de archivo de interés (sin ".").
|
String — Ruta de acceso de la aplicación predeterminada.
|
Emite
Error — Si el parámetro extension no contiene ninguna de las extensiones de archivo declaradas en el descriptor de la aplicación.
|
Elementos de API relacionados
isSetAsDefaultApplication | () | método |
public function isSetAsDefaultApplication(extension:String):Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Indica si la aplicación es la aplicación predeterminada actual para abrir archivos de la extensión especificada.
Compatibilidad con perfil de AIR: esta característica se admite en todos los sistemas operativos de escritorio, pero no en dispositivos móviles o en dispositivos de AIR para TV. Puede comprobar la compatibilidad en tiempo de ejecución mediante la propiedad NativeApplication.supportsDefaultApplication. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
Parámetros
extension:String — Objeto String que contiene la extensión del tipo de archivo de interés (sin ".").
|
Boolean — true si la aplicación es la predeterminada.
|
Emite
Error — Si el parámetro extension no contiene ninguna de las extensiones de archivo declaradas en el descriptor de la aplicación.
|
Elementos de API relacionados
paste | () | método |
public function paste():Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Invoca un comando paste interno en el objeto de visualización seleccionado.
Esta llamada a la función se omite si el componente no implementa el comando. Sólo se muestran objetos descendentes en las clases TextField o HTMLLoader que implementan actualmente este comando.
Valor devueltoBoolean — true.
|
removeAsDefaultApplication | () | método |
public function removeAsDefaultApplication(extension:String):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Elimina la aplicación como predeterminada para abrir archivos de la extensión especificada.
Nota: este método sólo puede utilizarse con tipos de archivo contenidos en la declaración fileTypes del descriptor de la aplicación.
Parámetros
extension:String — Objeto String que contiene la extensión del tipo de archivo de interés (sin ".").
|
Emite
Error — Si el parámetro extension no contiene ninguna de las extensiones de archivo declaradas en el descriptor de la aplicación.
|
Elementos de API relacionados
removeEventListener | () | método |
override public function removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void| Versiones de motor de ejecución: | AIR 1.0 |
Elimina un detector del objeto EventDispatcher. Si no hay ningún detector coincidente registrado con el objeto EventDispatcher, la llamada a este método no surtirá ningún efecto.
Parámetros
type:String — El tipo de evento.
| |
listener:Function — El objeto detector que se va a eliminar.
| |
useCapture:Boolean (default = false)removeEventListener() para eliminar ambos detectores: una llamada con useCapture() definido como true y otra llamada con useCapture() establecido en false.
|
selectAll | () | método |
public function selectAll():Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Invoca un comando selectAll interno en el objeto de visualización seleccionado.
Esta llamada a la función se omite si el componente no implementa el comando. Sólo se muestran objetos descendentes en las clases TextField o HTMLLoader que implementan actualmente este comando.
Valor devueltoBoolean — true.
|
setAsDefaultApplication | () | método |
public function setAsDefaultApplication(extension:String):void| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Define la aplicación como aplicación predeterminada para abrir archivos de la extensión especificada.
Nota: este método sólo puede utilizarse con tipos de archivo declarados en la declaración fileTypes del descriptor de la aplicación.
Parámetros
extension:String — Objeto String que contiene la extensión del tipo de archivo de interés (sin ".").
|
Emite
Error — Si el parámetro extension no contiene ninguna de las extensiones de archivo declaradas en el descriptor de la aplicación.
|
Elementos de API relacionados
activate | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.ACTIVATE| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye cuando esta aplicación pasa a ser la aplicación de escritorio activa.
La constanteACTIVATE define el valor de la propiedad type de un objeto de evento activate.
Nota: este evento no tiene ni "fase de captura" ni "fase de propagación", lo que significa que los detectores de eventos deben añadirse directamente a cualquier destino potencial, se encuentre o no en la lista de visualización.
Los dispositivos de AIR para TV nunca distribuyen automáticamente este evento. El usuario puede, sin embargo, distribuirlo manualmente.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Cualquier instancia de DisplayObject con un detector registrado para el evento activate. |
browserInvoke | Evento |
flash.events.BrowserInvokeEventpropiedad BrowserInvokeEvent.type =
flash.events.BrowserInvokeEvent.Browser_INVOKE| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye cuando un archivo SWF ejecutado en el navegador del usuario invoca una aplicación.
La invocación desde el navegador sólo está permitida si la aplicación especifica lo siguiente en el archivo descriptor de la aplicación:
<allowBrowserInvocation>true</allowBrowserInvocation>
deactivate | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.DEACTIVATE| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye cuando la selección del escritorio pasa a otra aplicación.
La constanteEvent.DEACTIVATE define el valor de la propiedad type de un objeto de evento deactivate.
Nota: este evento no tiene ni "fase de captura" ni "fase de propagación", lo que significa que los detectores de eventos deben añadirse directamente a cualquier destino potencial, se encuentre o no en la lista de visualización.
Los dispositivos de AIR para TV nunca distribuyen automáticamente este evento. El usuario puede, sin embargo, distribuirlo manualmente.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Cualquier instancia de DisplayObject con un detector registrado para el evento deactivate. |
exiting | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.EXITING| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye cuando se inicia la secuencia de cierre de la aplicación.
El evento exiting se distribuye cuando el sistema operativo inicia la secuencia de cierre de la aplicación, por ejemplo, cuando un usuario teclea la combinación de teclas Cmd-Q en Mac OS X, o cuando la propiedad autoExit del objeto NativeApplication es true y la última ventana de la aplicación se cierra. Si se cancela este evento, la aplicación no se cierra.
Los dispositivos de AIR para TV nunca distribuyen el evento exiting.
Nota: llamar al método exit() de NativeApplication no hace que se distribuya ningún evento exiting. Cuando se quiere advertir a los componentes del cierre inminente, se debe distribuir el evento exiting antes de llamar a exit().
Event.EXITING define el valor de la propiedad type de un objeto de evento exiting.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | true; al cancelar este objetos de evento se detiene la operación de salir. |
currentTarget | Objeto NativeApplication. |
target | Objeto NativeApplication. |
invoke | Evento |
flash.events.InvokeEventpropiedad InvokeEvent.type =
flash.events.InvokeEvent.INVOKE| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye cuando se invoca una aplicación.
Si se vuelve a invocar una aplicación, no se inicia otra instancia de la aplicación. En su lugar, la primera instancia recibe un evento invoke adicional. El control adecuado de los sucesivos eventos invoke es responsabilidad de la aplicación.
Nota: todos los eventos invoke se ponen en cola. Cuando se registra un detector para este evento, recibe todos los eventos de la cola y los eventos nuevos. Los eventos de la cola se pueden entregar antes o después de cualquier evento invoke nuevo.
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. |
keyDown | Evento |
flash.events.KeyboardEventpropiedad KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye cuando el usuario pulsa una tecla. La instancia de NativeApplication proporciona este evento para admitir atajos de teclado. Este evento de teclado se distribuye en primer lugar a la propiedad NativeApplication. Cancelar este evento también cancela los atajos de menú de NativeWindow. Este evento tiene lugar antes que el evento keyUp.
KeyboardEvent.KEY_DOWN define el valor de la propiedad type de un objeto de evento keyDown.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | true en AIR, false en Flash Player; en AIR, cancelar este evento impide que se puedan introducir caracteres en un campo de texto. |
charCode | El valor de código de carácter de la tecla presionada o soltada. |
commandKey | true en Mac si la tecla Comando está activa. En caso contrario, false |
controlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac si la tecla Control está activa. En caso contrario, false |
ctrlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | El valor de código de tecla de la tecla presionada o soltada. |
keyLocation | La ubicación de la tecla en el teclado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia InteractiveObject que está seleccionada. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
Elementos de API relacionados
keyUp | Evento |
flash.events.KeyboardEventpropiedad KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye cuando el usuario suelta una tecla. La instancia de NativeApplication proporciona este evento para admitir atajos de teclado. Este evento de teclado se distribuye en primer lugar a la propiedad NativeApplication. Cancelar este evento no tiene ningún efecto sobre otros objetos (como atajos de menú de NativeWindow). Este evento se produce después un evento keyDown.
KeyboardEvent.KEY_UP define el valor de la propiedad type de un objeto de evento keyUp.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
charCode | Contiene el valor de código de carácter de la tecla presionada o soltada. |
commandKey | true en Mac si la tecla Comando está activa. En caso contrario, false |
controlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac si la tecla Control está activa. En caso contrario, false |
ctrlKey | true en Windows, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | El valor de código de tecla de la tecla presionada o soltada. |
keyLocation | La ubicación de la tecla en el teclado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia InteractiveObject que está seleccionada. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
Elementos de API relacionados
networkChange | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.NETWORK_CHANGE| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye si una nueva conexión de red pasa a estar disponible o si se pierde una existente.
Un evento networkChange no significa necesariamente que el equipo host se haya conectado o desconectado; tal vez simplemente esté pasando de un tipo de conexión a otro. Las aplicaciones pueden utilizar este evento para mejorar la supervisión de disponibilidad de recursos remotos. La distribución de un evento networkChange suele ser un buen momento para verificar la disponiblidad de los recursos remotos.
Notas:
- Es posible que se produzca un pequeño desfase entre el cambio de la red y la entrega de este evento.
- En Android, el objeto NativeApplication puede distribuir más de un evento networkChange para cada cambio en una conexión de red.
Event.NETWORK_CHANGE define el valor de la propiedad type de un objeto de evento networkChange.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Objeto NativeApplication. |
suspend | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.SUSPEND| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3.3 |
Se distribuye cuando la aplicación se va a ser suspendida por el sistema operativo.
La constanteEvent.SUSPEND define el valor de la propiedad type de un objeto de evento suspend. Este evento solo se distribuye en AIR iOS.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto NativeApplication. |
target | Objeto NativeApplication. |
userIdle | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.USER_IDLE| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye cuando el usuario ha estado inactivo.
Especifique el periodo de tiempo durante el cual el usuario debe estar inactivo antes de este evento se distribuya mediante la propiedad idleThreshold. La cantidad de tiempo que el usuario permanece inactivo se puede determinar en la propiedad timeSinceLastUserInput.
Nota: este evento no se distribuye en dispositivos móviles ni en dispositivos de AIR para TV.
La constanteEvent.USER_IDLE define el valor de la propiedad type de un objeto de evento userIdle.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
target | Objeto NativeApplication. |
Elementos de API relacionados
userPresent | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.USER_PRESENT| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye cuando el sistema operativo detecta el movimiento del cursor o del ratón tras un periodo de inactividad.
Nota: este evento no se distribuye en dispositivos móviles ni en dispositivos de AIR para TV.
El periodo de tiempo que se considera inactivo se puede configurar en la propiedad idleThreshold. La cantidad de tiempo que el usuario permanece inactivo se puede determinar en la propiedad timeSinceLastUserInput.
Event.USER_PRESENT define el valor de la propiedad type de un objeto de evento userPresent.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
target | Objeto NativeApplication. |
Elementos de API relacionados
Tue Jun 12 2018, 02:12 PM Z