NativeApplication  - AS3

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.

Contenido del archivo descriptor de la aplicación de esta aplicación de 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);

ID de aplicación de esta aplicación.

El valor de este ID se establece en archivo descriptor de la aplicación.

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.

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.

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.

Elementos de API relacionados

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.

Elementos de API relacionados

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

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.

Elementos de API relacionados

La instancia simple del objeto NativeApplication.

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.

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.

Nivel de parche del motor de ejecución que aloja esta aplicación.

Número de versión del motor de ejecución que aloja esta aplicación.

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.

Elementos de API relacionados

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.

Elementos de API relacionados

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

Elementos de API relacionados

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

Elementos de API relacionados

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.

Elementos de API relacionados

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

Elementos de API relacionados

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.

Elementos de API relacionados

El tiempo, en segundos, desde la última entrada realizada por el usuario.

Elementos de API relacionados

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

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

function(evt:Event):void

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.

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.

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.

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

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

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

Elementos de API relacionados

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

Elementos de API relacionados

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.

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

Elementos de API relacionados

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

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.

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

Elementos de API relacionados

Se distribuye cuando esta aplicación pasa a ser la aplicación de escritorio activa.

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:

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>

Se distribuye cuando la selección del escritorio pasa a otra aplicación.

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:

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

Este evento tiene las propiedades siguientes:

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.

El objeto del evento InvokeEvent tiene las siguientes propiedades:

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.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

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.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

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.

Este evento tiene las propiedades siguientes:

Se distribuye cuando la aplicación se va a ser suspendida por el sistema operativo.

Este evento tiene las propiedades siguientes:

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.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados

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.

Este evento tiene las propiedades siguientes:

Elementos de API relacionados