Paquete | flash.display |
Clase | public class Stage |
Herencia | Stage DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object |
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Para el contenido SWF ejecutado en el navegador (en Flash® Player), el escenario representa toda el área en la que se muestra el contenido de Flash. Para contenido ejecutado en AIR en sistemas operativos de escritorio, cada objeto NativeWindow dispone de su objeto Stage correspondiente.
No es posible obtener acceso al objeto Stage de forma global. Es necesario acceder a él a través de la propiedad stage
de una instancia de DisplayObject.
La clase Stage tiene diversas clases ascendientes (DisplayObjectContainer, InteractiveObject, DisplayObject y EventDispatcher) de las que hereda propiedades y métodos. Muchas de estas propiedades y métodos no son aplicables a los objetos Stage o exigen comprobaciones de seguridad cuando se les llama en un objeto Stage. Las propiedades y los métodos que exigen comprobaciones de seguridad se documentan como parte de la clase Stage.
Además, las siguientes propiedades heredadas no son aplicables a los objetos Stage. Si intenta establecerlas, se emitirá un error IllegalOperationError. Estas propiedades siempre pueden leerse, pero dado que no pueden establecerse, siempre contienen valores predeterminados.
-
accessibilityProperties
-
alpha
-
blendMode
-
cacheAsBitmap
-
contextMenu
-
filters
-
focusRect
-
loaderInfo
-
mask
-
mouseEnabled
-
name
-
opaqueBackground
-
rotation
-
scale9Grid
-
scaleX
-
scaleY
-
scrollRect
-
tabEnabled
-
tabIndex
-
transform
-
visible
-
x
-
y
Algunos eventos que podrían considerarse parte de la clase Stage, como enterFrame
, exitFrame
, frameConstructed
o render
, no pueden ser eventos Stage porque no se puede garantizar la existencia de una referencia al objeto Stage en todos los casos en los que se utilizan los eventos. Como estos eventos no los puede distribuir el objeto Stage, los distribuye cada instancia de DisplayObject, lo que significa que es posible añadir un detector de eventos a cualquier instancia de DisplayObject para detectar estos eventos. Estos eventos, que forman parte de la clase DisplayObject, se denominan eventos de difusión para distinguirlos de los eventos que destinados a una instancia de DisplayObject específica. Otros dos eventos de difusión, activate
y deactivate
, pertenecen a la superclase de DisplayObject, EventDispatcher. Los eventos activate
y deactivate
se comportan de forma parecida a los eventos de difusión de DisplayObject, salvo en que estos dos eventos los distribuyen no sólo todas las instancias de DisplayObject, sino todas las instancias de EventDispatcher y las instancias de otras subclases de EventDispatcher. Para obtener más información sobre los eventos de difusión, consulte la clase DisplayObject.
Elementos de API relacionados
Propiedad | Definido por | ||
---|---|---|---|
accessibilityImplementation : AccessibilityImplementation
La implementación actual de accesibilidad (AccessibilityImplementation) para esta instancia de InteractiveObject. | InteractiveObject | ||
accessibilityProperties : AccessibilityProperties
Las opciones de accesibilidad actuales para este objeto de visualización. | DisplayObject | ||
align : String
Un valor de la clase StageAlign que especifica la alineación del escenario en Flash Player o el navegador. | Stage | ||
allowsFullScreen : Boolean [solo lectura]
Especifica si este escenario permite el uso del modo de pantalla completa
| Stage | ||
allowsFullScreenInteractive : Boolean [solo lectura]
Especifica si esta etapa permite utilizar la pantalla completa en el modo de entrada de texto
| Stage | ||
alpha : Number
Indica el valor de transparencia alfa del objeto especificado. | DisplayObject | ||
autoOrients : Boolean
Indica si el escenario se vuelve a orientar automáticamente cuando cambia la orientación del dispositivo. | Stage | ||
blendMode : String
Un valor de la clase BlendMode que especifica el modo de mezcla que debe utilizarse. | DisplayObject | ||
blendShader : Shader [solo escritura]
Define un sombreado para utilizarlo en la mezcla del primer plano y del fondo. | DisplayObject | ||
browserZoomFactor : Number [solo lectura]
Especifica el factor de zoom del navegador. | Stage | ||
cacheAsBitmap : Boolean
Si se define como true, los motores de ejecución de Flash dejan en caché una representación interna de mapa de bits del objeto de visualización. | DisplayObject | ||
cacheAsBitmapMatrix : Matrix
Si su valor no es null, este objeto Matrix define cómo un objeto de visualización se procesa cuando cacheAsBitmap se define como true. | DisplayObject | ||
color : uint
El color de fondo del SWF. | Stage | ||
colorCorrection : String
Controla la corrección del color del motor de ejecución de Flash en la pantalla. | Stage | ||
colorCorrectionSupport : String [solo lectura]
Especifica si el motor de ejecución de Flash se ejecuta en un sistema operativo que admite la corrección de color y si el perfil de color del monitor principal es comprensible y aceptable para el motor de ejecución de Flash. | Stage | ||
constructor : * | Stage | ||
contentsScaleFactor : Number [solo lectura]
Especifica el factor de escala de píxeles efectivos del escenario. | Stage | ||
contextMenu : NativeMenu
Especifica el menú contextual asociado a este objeto. | InteractiveObject | ||
deviceOrientation : String [solo lectura]
La orientación física del dispositivo. | Stage | ||
displayState : String
Un valor de la clase StageDisplayState que especifica el estado de visualización se utilizará. | Stage | ||
doubleClickEnabled : Boolean
Especifica si este objeto recibe eventos doubleClick. | InteractiveObject | ||
filters : Array
Conjunto indexado que contiene todos los objetos de filtro actualmente asociados con el objeto de visualización. | DisplayObject | ||
focus : InteractiveObject
El objeto interactivo que está seleccionado por el teclado; o null si no se ha establecido la selección o si el objeto seleccionado pertenece a un entorno limitado de seguridad al que el objeto que origina la llamada no dispone de acceso. | Stage | ||
focusRect : Object
Especifica si este objeto muestra un rectángulo de selección. | InteractiveObject | ||
frameRate : Number
Obtiene y establece la velocidad de fotogramas del escenario. | Stage | ||
fullScreenHeight : uint [solo lectura]
Devuelve la altura del monitor que se utilizará cuando se pase al tamaño de pantalla completa, si ese estado se activa inmediatamente. | Stage | ||
fullScreenSourceRect : Rectangle
Establece el motor de ejecución de Flash para que ajuste una región concreta en el modo de pantalla completa. | Stage | ||
fullScreenWidth : uint [solo lectura]
Devuelve la anchura del monitor que se utilizará cuando se pase al tamaño de pantalla completa, si ese estado se activa inmediatamente. | Stage | ||
height : Number [override]
Indica la altura del objeto de visualización, expresada en píxeles. | Stage | ||
loaderInfo : LoaderInfo [solo lectura]
Devuelve un objeto LoaderInfo que contiene información sobre la carga del archivo al que pertenece este objeto de visualización. | DisplayObject | ||
mask : DisplayObject
El objeto de visualización que origina la llamada se enmascara mediante el objeto mask especificado. | DisplayObject | ||
metaData : Object
Obtiene el objeto de metadatos de la instancia de DisplayObject si los metadatos se almacenaron con la instancia de este objeto DisplayObject en el archivo SWF a través de una etiqueta PlaceObject4. | DisplayObject | ||
mouseChildren : Boolean [override]
Determina si los elementos secundarios del objeto están activados para acciones de ratón o de dispositivo de entrada de usuario. | Stage | ||
mouseEnabled : Boolean
Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes. | InteractiveObject | ||
mouseLock : Boolean
Establézcalo como true para activar el bloqueo del ratón. | Stage | ||
mouseX : Number [solo lectura]
Indica la coordenada x de la posición del ratón o del dispositivo de entrada del usuario, en píxeles. | DisplayObject | ||
mouseY : Number [solo lectura]
Indica la coordenada y de la posición del ratón o del dispositivo de entrada del usuario, en píxeles. | DisplayObject | ||
name : String
Indica el nombre de instancia de DisplayObject. | DisplayObject | ||
nativeWindow : NativeWindow [solo lectura]
Referencia al objeto NativeWindow que contiene este elemento Stage. | Stage | ||
needsSoftKeyboard : Boolean
Especifica si un teclado virtual (teclado en pantalla) se debe mostrar cuando esta instancia de InteractiveObject recibe la selección. | InteractiveObject | ||
numChildren : int [override] [solo lectura]
Devuelve el número de elementos secundarios de este objeto. | Stage | ||
opaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo. | DisplayObject | ||
orientation : String [solo lectura]
La orientación actual del escenario. | Stage | ||
parent : DisplayObjectContainer [solo lectura]
Indica el objeto DisplayObjectContainer que contiene este objeto de visualización. | DisplayObject | ||
quality : String
Valor de la clase StageQuality que especifica la calidad de representación que se utiliza. | Stage | ||
root : DisplayObject [solo lectura]
Para un objeto de visualización en un archivo SWF cargado, la propiedad root es el objeto de visualización de nivel más alto en la parte de la estructura de árbol de la lista de visualización representada por dicho archivo SWF. | DisplayObject | ||
rotation : Number
Indica el giro de la instancia de DisplayObject, expresado en grados, con respecto a su orientación original. | DisplayObject | ||
rotationX : Number
Indica la rotación del eje x de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D. | DisplayObject | ||
rotationY : Number
Indica la rotación del eje y de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D. | DisplayObject | ||
rotationZ : Number
Indica la rotación del eje z de la instancia de DisplayObject, en grados, desde su orientación original relativa al contenedor principal 3D. | DisplayObject | ||
scale9Grid : Rectangle
La cuadrícula de escala aplicada actualmente. | DisplayObject | ||
scaleMode : String
Un valor de la clase StageScaleMode que especifica el modo de escala que debe utilizarse. | Stage | ||
scaleX : Number
Indica la escala horizontal (percentage) del objeto aplicada desde el punto de registro. | DisplayObject | ||
scaleY : Number
Indica la escala vertical (percentage) de un objeto aplicada desde el punto de registro del objeto. | DisplayObject | ||
scaleZ : Number
Indica la escala de profundidad (porcentaje) de un objeto aplicada desde el punto de registro del objeto. | DisplayObject | ||
scrollRect : Rectangle
Los límites del rectángulo de desplazamiento del objeto de visualización. | DisplayObject | ||
showDefaultContextMenu : Boolean
Especifica si deben mostrarse u ocultarse los elementos predeterminados del menú contextual del motor de ejecución de Flash. | Stage | ||
softKeyboard : String
Controla la apariencia del teclado virtual. | InteractiveObject | ||
softKeyboardInputAreaOfInterest : Rectangle
Define el área que debe permanecer en pantalla cuando se muestra un teclado virtual (no disponible en iOS). | InteractiveObject | ||
softKeyboardRect : Rectangle [solo lectura]
Un objeto Rectangle que especifica el área del escenario actualmente ocupada por un teclado en pantalla. | Stage | ||
stage : Stage [solo lectura]
El escenario del objeto de visualización. | DisplayObject | ||
stage3Ds : Vector.<Stage3D> [solo lectura]
Una lista de objetos Stage3D disponibles para mostrar contenido tridimensional. | Stage | ||
stageFocusRect : Boolean
Especifica si los objetos deben mostrar un borde brillante cuando están seleccionados. | Stage | ||
stageHeight : int
La altura actual del escenario en píxeles. | Stage | ||
stageVideos : Vector.<StageVideo> [solo lectura]
Una lista de objetos StageVideo disponibles para reproducir vídeos externos. | Stage | ||
stageWidth : int
Especifica la anchura actual del escenario en píxeles. | Stage | ||
supportedOrientations : Vector.<String> [solo lectura]
Las orientaciones admitidas por el dispositivo actual. | Stage | ||
supportsOrientationChange : Boolean [estática] [solo lectura]
Si la aplicación admite cambios en la orientación del escenario (y rotación de dispositivo) | Stage | ||
tabChildren : Boolean [override]
Determina si los elementos secundarios del objeto están habilitados para tabulación. | Stage | ||
tabEnabled : Boolean
Especifica si este objeto está en el orden de tabulación. | InteractiveObject | ||
tabIndex : int
Especifica el orden de tabulación de los objetos de un archivo SWF. | InteractiveObject | ||
textSnapshot : flash.text:TextSnapshot [override] [solo lectura]
Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer. | Stage | ||
transform : flash.geom:Transform
Objeto con propiedades pertenecientes a una matriz, transformación de color y límites de píxel de un objeto de visualización. | DisplayObject | ||
visible : Boolean
Indica si el objeto de visualización es visible. | DisplayObject | ||
vsyncEnabled : Boolean
Esto representa el estado actual de la propiedad vsync de la solución de gráficos subyacente. Se puede activar o desactivar vsync, por lo que se procesaría inmediatamente sin tener que esperar al siguiente estado de VSYNC. | Stage | ||
width : Number [override]
Indica la anchura del objeto de visualización, expresada en píxeles. | Stage | ||
wmodeGPU : Boolean [solo lectura]
Indica si está disponible composición con GPU y si está en uso. | Stage | ||
x : Number
Indica la coordenada x de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. | DisplayObject | ||
y : Number
Indica la coordenada y de la instancia de DisplayObject en relación a las coordenadas locales del DisplayObjectContainer principal. | DisplayObject | ||
z : Number
Indica la posición de la coordenada z en el eje z de la instancia de DisplayObject relativa al contenedor principal 3D. | DisplayObject |
Método | Definido por | ||
---|---|---|---|
[override]
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer. | Stage | ||
[override]
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer. | Stage | ||
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. | Stage | ||
Indica si las restricciones de seguridad provocarían la omisión de objetos de visualización de la lista devuelta al llamar al método DisplayObjectContainer.getObjectsUnderPoint() con el punto point especificado. | DisplayObjectContainer | ||
Establece la selección del teclado en el objeto interactivo especificado por objectToFocus, con al dirección de selección especificada por el parámetro direction. | Stage | ||
Determina si el objeto de visualización especificado es un elemento secundario de la instancia de DisplayObjectContainer o la propia instancia. | DisplayObjectContainer | ||
[override]
Distribuye un evento en el flujo del evento. | Stage | ||
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace. | DisplayObject | ||
Devuelve la instancia del objeto de visualización secundario que sale del índice especificado. | DisplayObjectContainer | ||
Devuelve el objeto de visualización secundario que sale con el nombre especificado. | DisplayObjectContainer | ||
Devuelve la posición de índice de una instancia secundaria de DisplayObject. | DisplayObjectContainer | ||
Devuelve un conjunto de objetos que quedan bajo el punto especificado y son elementos secundarios (o terciarios, etc.) de esta instancia de DisplayObjectContainer. | DisplayObjectContainer | ||
Devuelve un rectángulo que define el límite del objeto de visualización, basado en el sistema de coordenadas definido por el parámetro targetCoordinateSpace, excluyendo los trazos en las formas. | DisplayObject | ||
Convierte el objeto point de las coordenadas del escenario (globales) en las coordenadas del objeto de visualización (locales). | DisplayObject | ||
Convierte un punto bidimensional de las coordenadas (globales) del escenario en coordenadas (locales) de un objeto tridimensional. | DisplayObject | ||
[override]
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | Stage | ||
Indica si un objeto tiene definida una propiedad especificada. | Object | ||
Calcula el cuadro delimitador del objeto de visualización para ver si se solapa o corta con el cuadro delimitador del objeto de visualización obj. | DisplayObject | ||
Evalúa el objeto de visualización para comprobar si se solapa o presenta un punto de intersección con el punto especificado por los parámetros x e y. | DisplayObject | ||
Al llamar al método invalidate(), se indica a los motores de ejecución de Flash que avisen a los objetos de visualización de la próxima oportunidad que tendrán para representar la lista de visualización (por ejemplo, cuando la cabeza lectora avanza a un nuevo fotograma). | Stage | ||
Determina si la propiedad Stage.focus devuelve null por motivos de seguridad. | Stage | ||
Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro. | Object | ||
Convierte un punto tridimensional de las coordenadas (locales) del objeto de visualización tridimensional en un punto bidimensional en las coordenadas (globales) del escenario. | DisplayObject | ||
Convierte el objeto point de coordenadas del objeto de visualización (locales) en coordenadas del escenario (globales). | DisplayObject | ||
Indica si existe la propiedad especificada y si es enumerable. | Object | ||
Elimina la instancia child de DisplayObject especificada de la lista de elementos secundarios de la instancia de DisplayObjectContainer. | DisplayObjectContainer | ||
[override]
Elimina una instancia de DisplayObject secundaria de la posición de índice especificada en la lista de elementos secundarios de DisplayObjectContainer. | Stage | ||
Elimina todas las instancias child de DisplayObject especificadas de la lista de elementos secundarios de la instancia de DisplayObjectContainer. | DisplayObjectContainer | ||
Elimina un detector del objeto EventDispatcher. | EventDispatcher | ||
Muestra un teclado virtual. | InteractiveObject | ||
Establece la orientación del escenario según la relación de aspecto especificada. | Stage | ||
[override]
Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización. | Stage | ||
Establece el escenario con la orientación especificada. | Stage | ||
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | ||
Se detiene gradualmente la ejecución de línea de tiempo de todos los objetos MovieClip con raíz en este objeto. | DisplayObjectContainer | ||
Intercambia el orden z (de delante a atrás) de los dos objetos secundarios especificados. | DisplayObjectContainer | ||
[override]
Intercambia el orden z (de delante a atrás) de los objetos secundarios situados en las posiciones de índice especificadas en la lista de elementos secundarios. | Stage | ||
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 | ||
[override]
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | Stage |
Evento | Resumen | Definido por | ||
---|---|---|---|---|
[evento broadcast] Se distribuye cuando Flash Player o AIR pasan a estar activos. | EventDispatcher | |||
Se distribuye cuando un objeto de visualización se añade a la lista de visualización. | DisplayObject | |||
Se distribuye cuando un objeto de visualización se añade a la lista de visualización del escenario, bien directamente o a través de un subárbol que contiene el objeto de visualización. | DisplayObject | |||
Se distribuye cuando la propiedad browserZoomFactor del objeto Stage cambia. | Stage | |||
Se distribuye cuando el usuario selecciona 'Borrar' (o 'Eliminar') en el menú contextual. | InteractiveObject | |||
Se distribuye cuando un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject. | InteractiveObject | |||
Se distribuye cuando un gesto de usuario activa el menú contextual asociado al objeto interactivo la aplicación de AIR. | InteractiveObject | |||
Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para copiar elementos, o bien cuando el usuario elige la opción 'Copiar' en el menú contextual. | InteractiveObject | |||
Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para cortar elementos, o bien cuando el usuario elige la opción 'Cortar' en el menú contextual. | InteractiveObject | |||
[evento broadcast] Se distribuye cuando Flash Player o de AIR pasan a estar inactivos. | EventDispatcher | |||
Se distribuye cuando un usuario pulsa y suelta el botón principal de un dispositivo de señalización dos veces en una sucesión rápida sobre el mismo objeto InteractiveObject cuando el indicador doubleClickEnabled de dicho objeto se ha definido como true. | InteractiveObject | |||
[evento de difusión] Se distribuye cuando la cabeza lectora entra en un nuevo fotograma. | DisplayObject | |||
[evento de difusión] Se distribuye cuando la cabeza lectora sale del fotograma actual. | DisplayObject | |||
Se distribuye después de que un objeto de visualización quede seleccionado. | InteractiveObject | |||
Se distribuye después de que un objeto de visualización deje de estar seleccionado. | InteractiveObject | |||
[evento de difusión] Se distribuye una vez ejecutados los constructores de los objetos de visualización del fotograma, pero antes de que se ejecuten los scripts de fotograma. | DisplayObject | |||
Se distribuye cuando el objeto Stage pasa a, o deja de estar en, modo de pantalla completa. | Stage | |||
Se distribuye cuando el usuario crea un punto de contacto a lo largo del borde de la superficie de toque con una instancia de InteractiveObject (por ejemplo, toque a lo largo del borde de la superficie de toque en el servidor de Siri para Apple TV). Algunos dispositivos también pueden interpretar este contacto como una combinación de varios eventos táctiles. | InteractiveObject | |||
Se distribuye cuando el usuario presiona dos puntos de contacto en la misma instancia de InteractiveObject en un dispositivo táctil (como, por ejemplo, pulsar y soltar dos dedos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | |||
Se distribuye cuando el usuario mueve un punto de contacto sobre la instancia de InteractiveObject de un dispositivo táctil (como mover los dedos de izquierda a derecha sobre un objeto de visualización en un teléfono móvil o dispositivo con pantalla táctil). | InteractiveObject | |||
Se distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y girarlos sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | |||
Se distribuye cuando el usuario realiza un gesto de barrido en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con tres dedos y, a continuación, moverlos en paralelo sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | |||
Se distribuye cuando el usuario crea un punto de contacto con una instancia de InteractiveObject, seguidamente toca un dispositivo táctil (como colocar varios dedos sobre un objeto de visualización para abrir un menú y, a continuación, toca con un dedo para seleccionar un elemento de menú en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | |||
Se distribuye cuando el usuario realiza un gesto de zoom en un punto de contacto con una instancia de InteractiveObject (como, por ejemplo, tocar una pantalla con dos dedos y, a continuación, separarlos rápidamente sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | |||
Este evento se distribuye a cualquier cliente app que admite entrada en línea con un IME | InteractiveObject | |||
Se distribuye cuando el usuario pulsa una tecla. | InteractiveObject | |||
Se distribuye cuando el usuario intenta cambiar la selección empleando la navegación mediante teclado. | InteractiveObject | |||
Se distribuye cuando el usuario suelta una tecla. | InteractiveObject | |||
Se distribuye cuando un usuario pulsa y suelta el botón central del dispositivo de señalización sobre el mismo objeto InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario pulsa el botón central del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario intenta cambiar la selección empleando un dispositivo de señalización. | InteractiveObject | |||
Lo distribuye el objeto Stage cuando el puntero sale del área del escenario. | Stage | |||
Se distribuye cuando el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando se presiona la rueda del ratón sobre una instancia de InteractiveObject. | InteractiveObject | |||
Distribuido por el objeto InteractiveObject iniciador de arrastre cuando el usuario suelta el botón y finaliza el arrastre. | InteractiveObject | |||
Distribuido por el objeto InteractiveObject de destino cuando un objeto arrastrado se coloca sobre el objeto y la colocación se acepta con una llamada a DragManager.acceptDragDrop(). | InteractiveObject | |||
Distribuido por un objeto InteractiveObject cuando la acción de arrastre entra en sus límites. | InteractiveObject | |||
Distribuido por un objeto InteractiveObject cuando la acción de arrastre se sale de los límites. | InteractiveObject | |||
Distribuido continuamente por un objeto InteractiveObject mientras la operación de arrastre se mantiene dentro de sus límites. | InteractiveObject | |||
Distribuido al comienzo de una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag(). | InteractiveObject | |||
Distribuido durante una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag(). | InteractiveObject | |||
Distribuido por el objeto Stage cuando cambia la orientación del escenario. | Stage | |||
Distribuido por el objeto Stage cuando la orientación del escenario comienza a cambiar. | Stage | |||
Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para pegar elementos, o bien cuando el usuario elige la opción 'Pegar' en el menú contextual. | InteractiveObject | |||
Se distribuye cuando el usuario baja un lápiz stylus activo más allá del umbral de detección de proximidad de la pantalla. | InteractiveObject | |||
Se distribuye cuando el usuario levanta un lápiz stylus activo por encima del umbral de detección de proximidad de la pantalla. | InteractiveObject | |||
Se distribuye cuando el usuario pasa un lápiz stylus activo por encima de la pantalla sin salir del umbral de detección de proximidad. | InteractiveObject | |||
Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla. | InteractiveObject | |||
Se distribuye cuando el usuario pasa un lápiz stylus activo directamente por encima de este objeto InteractiveObject permaneciendo dentro del umbral de detección de proximidad de la pantalla. | InteractiveObject | |||
Se distribuye cuando el usuario quita un lápiz stylus activo de encima de este objeto InteractiveObject y sus elementos secundarios permaneciendo dentro del umbral de detección de proximidad de la pantalla. | InteractiveObject | |||
Se distribuye cuando el usuario pasa un lápiz stylus activo por encima de este objeto InteractiveObject desde fuera del árbol de descendientes del objeto en la lista de visualización (permaneciendo dentro del umbral de detección de proximidad de la pantalla). | InteractiveObject | |||
Se distribuye cuando el usuario suelta el botón del dispositivo señalador por primera vez después de que el usuario presiona el botón sobre una instancia de InteractiveObject y, a continuación, mueve el dispositivo de señalización fuera de la instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización. | DisplayObject | |||
Se distribuye cuando un objeto de visualización se va a eliminar de la lista de visualización, bien directamente o a través de la eliminación de un subárbol que contiene el objeto de visualización. | DisplayObject | |||
[evento de difusión] Se distribuye cuando la lista de visualización se va a actualizar y representar. | DisplayObject | |||
Se distribuye cuando la propiedad scaleMode del objeto Stage se define como StageScaleMode.NO_SCALE y se cambia el tamaño del archivo SWF. | Stage | |||
Se distribuye cuando un usuario pulsa y suelta el botón derecho del dispositivo de señalización sobre el mismo objeto InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject. | InteractiveObject | |||
Se distribuye cuando el usuario activa la combinación de teclas aceleradoras específica de la plataforma en que se encuentra para seleccionar todos los elementos, o bien cuando el usuario elige la opción 'Seleccionar todo' en el menú contextual. | InteractiveObject | |||
Se distribuye inmediatamente una vez mostrado el teclado en pantalla. | InteractiveObject | |||
Se distribuye inmediatamente antes de que se muestre el teclado en pantalla. | InteractiveObject | |||
Se distribuye inmediatamente una vez oculto el teclado en pantalla. | InteractiveObject | |||
Distribuido por el objeto Stage cuando cambia el estado de la propiedad stageVideos. | Stage | |||
Se distribuye cuando cambia el valor del indicador tabChildren del objeto. | InteractiveObject | |||
Se distribuye cuando cambia el indicador tabEnabled del objeto. | InteractiveObject | |||
Se distribuye cuando cambia el valor de la propiedad tabIndex del objeto. | InteractiveObject | |||
Se distribuye cuando un usuario escribe uno o varios caracteres de texto. | InteractiveObject | |||
Se distribuye cuando el usuario toca por primera vez un dispositivo táctil (por ejemplo, toca un teléfono móvil o dispositivo con pantalla táctil con un dedo). | InteractiveObject | |||
Se distribuye cuando el usuario elimina el contacto con un dispositivo táctil (como levantar un dedo de un teléfono móvil o dispositivo con pantalla táctil). | InteractiveObject | |||
Se distribuye cuando el usuario toca el dispositivo y se distribuye constantemente hasta que desaparece el punto de contacto. | InteractiveObject | |||
Se distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a otro en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | |||
Se distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | |||
Se distribuye cuando el usuario retira el punto de contacto de una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un objeto de visualización a un punto fuera del objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | |||
Se distribuye cuando el usuario mueve el punto de contacto sobre una instancia de InteractiveObject en un dispositivo táctil (como arrastrar un dedo desde un punto fuera de un objeto de visualización en un punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | |||
Se distribuye cuando el usuario levanta el punto de contacto en la misma instancia de InteractiveObject en la que se inició el contacto en un dispositivo táctil (como, por ejemplo, pulsar y soltar un dedo desde un único punto sobre un objeto de visualización en un teléfono móvil o en un dispositivo con pantalla táctil). | InteractiveObject | |||
Distribuido por el objeto Stage cuando cambia el estado de la propiedad vsync. | Stage |
align | propiedad |
align:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un valor de la clase StageAlign que especifica la alineación del escenario en Flash Player o el navegador. Los valores siguientes son válidos:
Valor | Alineación vertical | Horizontal |
---|---|---|
StageAlign.TOP | Superior | Centro |
StageAlign.BOTTOM | Inferior | Centro |
StageAlign.LEFT | Centro | Izquierda |
StageAlign.RIGHT | Centro | Derecha |
StageAlign.TOP_LEFT | Superior | Izquierda |
StageAlign.TOP_RIGHT | Superior | Derecha |
StageAlign.BOTTOM_LEFT | Inferior | Izquierda |
StageAlign.BOTTOM_RIGHT | Inferior | Derecha |
La propiedad align
sólo está disponible para un objeto que esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del objeto que origina la llamada llamando al método Security.allowDomain()
o Security.alowInsecureDomain()
. Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
Implementación
public function get align():String
public function set align(value:String):void
Elementos de API relacionados
allowsFullScreen | propiedad |
allowsFullScreenInteractive | propiedad |
allowsFullScreenInteractive:Boolean
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11.3, AIR 1.0 |
Especifica si esta etapa permite utilizar la pantalla completa en el modo de entrada de texto
Implementación
public function get allowsFullScreenInteractive():Boolean
autoOrients | propiedad |
autoOrients:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2 |
Indica si el escenario se vuelve a orientar automáticamente cuando cambia la orientación del dispositivo.
El valor de esta propiedad se deriva del elemento autoOrients
del archivo descriptor de la aplicación y el valor predeterminado es false
. Al cambiar la propiedad a false
, el comportamiento no se garantiza. En algunos dispositivos, el escenario permanece con la orientación actual. En otros, la orientación del escenario cambia a una orientación “estándar” definida por el dispositivo. Después de este cambio, no se produce ninguna otra modificación de la orientación del escenario.
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. Puede comprobar la compatibilidad en tiempo de ejecución mediante la propiedad Stage.supportsOrientantionChange
. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
Implementación
public function get autoOrients():Boolean
public function set autoOrients(value:Boolean):void
Elementos de API relacionados
browserZoomFactor | propiedad |
browserZoomFactor:Number
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 15 |
Especifica el factor de zoom del navegador. Un cambio en el factor de zoom del navegador afecta al factor de escala del escenario.
Implementación
public function get browserZoomFactor():Number
color | propiedad |
color:uint
Versiones de motor de ejecución: | Flash Player 10.2, AIR 2.5 |
El color de fondo del SWF.
Valores predeterminados para el color de fondo del escenario, según lo establecido por la etiqueta SWF SetBackgroundColor.
Implementación
public function get color():uint
public function set color(value:uint):void
colorCorrection | propiedad |
colorCorrection:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Controla la corrección del color del motor de ejecución de Flash en la pantalla. La corrección de color sólo funciona correctamente si el monitor principal tiene asignado un perfil de color ICC válido en el que se especifiquen los atributos de color concretos del dispositivo. De forma predeterminada, el motor de ejecución de Flash intenta ajustarse a la corrección de color del host (normalmente, un navegador).
Utilice la propiedad Stage.colorCorrectionSupport
para determinar si la corrección de color está disponible en el sistema actual y para fijar su estado predeterminado. Si está disponible, se asume que todos los colores del escenario pertenecen al espacio de color sRGB (el espacio de color estándar). Los perfiles de origen de dispositivos de entrada no se tienen en cuenta durante la corrección de color. No se aplica ninguna corrección de color de entrada; sólo se asigna la salida del escenario al perfil de color ICC del monitor principal.
En términos generales, las ventajas de activar la gestión de color incluyen la obtención de colores coherentes y predecibles, una mejor conversión, comprobaciones precisas y salida más eficaz en los distintos medios. No obstante, debe tener en cuenta que la gestión de color no proporciona conversiones perfectas, ya que el gamut de los dispositivos es exclusivo o contienen imágenes originales. La gestión de color tampoco elimina la necesidad perfiles personalizados o editados. Los perfiles de color dependen del navegador, del sistema operativo (SO), de las extensiones del SO, de los dispositivos de salida y de la compatibilidad de las aplicaciones.
Cuando se aplica corrección de color, disminuye el rendimiento del motor de ejecución de Flash. La corrección de color del motor de ejecución de Flash es una corrección de color de estilo de documento, ya que todas las películas SWF se consideran documentos con perfiles RVA implícitos. Utilice la propiedad Stage.colorCorrectionSupport
para instruir al motor de ejecución de Flash para que corrija los colores al visualizar el archivo (documento) SWF en el espacio de color de visualización. Los motores de ejecución de Flash sólo compensan las diferencias entre monitores, no las diferencias entre dispositivos de entrada (cámara, escáner, etc.).
Los tres posibles valores son cadenas con constantes correspondientes en la clase flash.display.ColorCorrection:
"default"
: utiliza misma corrección de color que el sistema host."on"
: realiza siempre la corrección de color."off"
: no realiza nunca la corrección de color.
Implementación
public function get colorCorrection():String
public function set colorCorrection(value:String):void
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
Stage.colorCorrection
no es un valor de la clase ColorCorrection, el controlador informa de un error.
function addHandler(add_event:Event) { switch(stage.colorCorrection) { case ColorCorrection.ON: stage.colorCorrection = ColorCorrection.OFF; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.OFF: stage.colorCorrection = ColorCorrection.DEFAULT; lblCMEnableState.text = "State: " + stage.colorCorrection; break; case ColorCorrection.DEFAULT: stage.colorCorrection = ColorCorrection.ON; lblCMEnableState.text = "State: " + stage.colorCorrection; break; default: lblCMEnableState.text = "Error."; break; }
colorCorrectionSupport | propiedad |
colorCorrectionSupport:String
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
Especifica si el motor de ejecución de Flash se ejecuta en un sistema operativo que admite la corrección de color y si el perfil de color del monitor principal es comprensible y aceptable para el motor de ejecución de Flash. Esta propiedad también devuelve el estado predeterminado de la corrección de color en el sistema host (normalmente, el navegador). Actualmente, los valores devueltos pueden ser:
Los tres valores posible son cadenas con sus correspondientes constantes en la clase flash.display.ColorCorrectionSupport:
"unsupported"
: la corrección de color no está disponible."defaultOn"
: la corrección de color se realiza siempre."defaultOff"
: la corrección de color no se realiza nunca.
Implementación
public function get colorCorrectionSupport():String
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
stage.colorCorrectionSupport
para ver si es DEFAULT_ON
o DEFAULT_OFF
, los valores de la clase ColorCorrectionSupport. Si la propiedad es cualquiera de los dos valores, el campo de texto muestra el valor actual. En caso contrario, si el valor no es ni DEFAULT_ON
ni DEFAULT_OFF
, el campo de texto muestra "no admitidos".
function addHandler(add_event:Event) { if (stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_ON || stage.colorCorrectionSupport == ColorCorrectionSupport.DEFAULT_OFF) { lblHasCM.text = "stage.colorCorrectionSupport: " + stage.colorCorrectionSupport; } else { lblHasCM.text = "stage.colorCorrectionSupport: unsupported"; } }
constructor | propiedad |
contentsScaleFactor | propiedad |
contentsScaleFactor:Number
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 11.5 |
Especifica el factor de escala de píxeles efectivos del escenario. Este valor es 1 en las pantallas estándar y las pantallas HiDPI (pantallas Retina). Cuando el escenario se procesa en pantallas HiDPI, se duplica la resolución de píxeles; incluso si el modo de escala del escenario se establece en StageScaleMode.NO_SCALE. Stage.stageWidth y Stage.stageHeight que se siguen registrando en unidades de píxeles clásicos.
Implementación
public function get contentsScaleFactor():Number
deviceOrientation | propiedad |
deviceOrientation:String
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2 |
La orientación física del dispositivo.
En dispositivos con teclado emergente, el estado del teclado tiene mayor prioridad en la determinación del orientación de dispositivo que la rotación detectada por el acelerómetro. Por lo tanto, en un dispositivo con detección de aspecto con un teclado emergente, la propiedad deviceOrientation
informará a ROTATED_LEFT
cuando el teclado esté abierto independientemente de cómo mantenga el usuario el dispositivo.
Utilice las constantes definidas en la clase StageOrientation al establecer o comparar valores para esta propiedad.
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. Puede probar la compatibilidad en tiempo de ejecución con la propiedad Stage.supportsOrientationChange
. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
Implementación
public function get deviceOrientation():String
Elementos de API relacionados
displayState | propiedad |
displayState:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Un valor de la clase StageDisplayState que especifica el estado de visualización se utilizará. Los valores siguientes son válidos:
StageDisplayState.FULL_SCREEN
Configura la aplicación de AIR o el contenido en Flash Player para ampliar el escenario a toda la pantalla del usuario. Se desactiva la entrada de teclado con la excepción de un conjunto de claves que no son de impresión.StageDisplayState.FULL_SCREEN_INTERACTIVE
: configura la aplicación para que expanda el escenario a toda la pantalla del usuario, con la entrada de teclado activada. (Disponible en AIR y Flash Player, a partir de Flash Player 11.3.)StageDisplayState.NORMAL
: devuelve el escenario al modo de visualización de escenario estándar.
El comportamiento de la escala de la película en modo de pantalla completa viene determinado por el valor scaleMode
(definido por la propiedad Stage.scaleMode
de los valores de etiqueta embed
del archivo SWF en el archivo HTML). Si la propiedad scaleMode
se establece en noScale
mientras la aplicación pasa al modo de pantalla completa, las propiedades width
y height
de Stage se actualizan y Stage distribuye un evento resize
. Si se define cualquier otro modo de escala, se cambiará la escala del escenario y su contenido para rellenar las nuevas dimensiones de la pantalla. El objeto Stage original conserva sus valores width
y height
y no distribuye un evento resize
.
Se aplican las siguientes restricciones a los archivos SWF que se reproducen en una página HTML (no los del reproductor autónomo de Flash Player o los del motor de ejecución de AIR):
- Para activar el modo de pantalla completa, añada el parámetro
allowFullScreen
a las etiquetasobject
yembed
en la página HTML que incluye el archivo SWF, conallowFullScreen
definido como"true"
, como se muestra en el siguiente ejemplo:<param name="allowFullScreen" value="true" /> ... <embed src="example.swf" allowFullScreen="true" ... >
Una página HTML también puede utilizar un script para generar etiquetas que incorporan SWF. Es necesario que altere el script para que inserte el parámetro
allowFullScreen
adecuado. Las páginas HTML generadas por el motor de ejecución de Flash Professional y FlexBuilder utilizan la funciónAC_FL_RunContent()
para incorporar referencias a archivos SWF y necesita añadir los valores de parámetroallowFullScreen
, como se muestra a continuación:AC_FL_RunContent( ... "allowFullScreen", "true", ... )
- El modo de pantalla completa se inicia en respuesta al clic del ratón o a la pulsación de una tecla por parte del usuario; la película no puede cambiar
Stage.displayState
sin una entrada del usuario. El motor de ejecución de Flash limita la entrada del teclado en modo de pantalla completa. Entre las teclas que se aceptan se incluyen los métodos abreviados de teclado que finalizan el modo de pantalla completa, así como las teclas no imprimibles como, por ejemplo, teclas de dirección, espacio, Mayús y tabuladores. (Utilice el modo interactivo de pantalla completa para admitir la introducción con más teclas.) Los métodos abreviados de teclado que finalizan el modo de pantalla completa son: Esc (Windows, Linux y Mac), Control + W (Windows), Comando + W (Mac) y Alt + F4. - A partir de Flash Player 9.0.115.0, la pantalla completa funciona igual en el modo sin ventanas que en el modo de ventanas. Si establece el modo de ventana (
wmode
en el HTML) en Opaco sin ventanas (opaque
) o Transparente sin ventanas (transparent
), se puede iniciar la pantalla completa, pero la ventana será siempre opaca. - Para activar el modo de pantalla completa, que admite interactividad con el teclado, añada el parámetro
allowFullScreenInteractive
a las etiquetasobject
yembed
en la página HTML que incluye el archivo SWF, conallowFullScreenInteractive
definido como"true"
, como se muestra en el siguiente ejemplo:<param name="allowFullScreenInteractive" value="true" /> ...
Estas restricciones no se aplican al contenido de SWF ejecutado en el reproductor autónomo de Flash Player o en AIR.
Cuando se entra en modo de pantalla completa, el motor de ejecución de Flash muestra brevemente una notificación sobre el contenido SWF para informar a los usuarios de que se encuentran en modo de pantalla completa y que pueden pulsar la tecla Escape para salir del modo de pantalla completa.
Cuando se entra en modo interactivo de pantalla completa, Flash Player muestra un mensaje de confirmación sobre el contenido SWF que permite a los usuarios acceder a un teclado ampliado (con teclas de impresión) e informa a los usuarios de que pueden pulsar la tecla Escape para salir del modo interactivo de pantalla completa. No debe asumir el aspecto ni la ubicación del mensaje de confirmación. Puede determinar si los usuarios han permitido que aparezca el teclado ampliado si detecta el evento FullScreenEvent.FULL_SCREEN_INTERACTIVE_ACCEPTED
.
Para contenido de AIR ejecutado en modo de pantalla completa, el protector de pantalla y las opciones de ahorro de energía del sistema se desactivan durante la reproducción del contenido de vídeo hasta que éste se detiene o hasta salir del modo de pantalla completa.
En Linux, establecer displayState
en StageDisplayState.FULL_SCREEN
o StageDisplayState.FULL_SCREEN_INTERACTIVE
es una operación asíncrona.
Implementación
public function get displayState():String
public function set displayState(value:String):void
Emite
SecurityError — Al llamar a la propiedad displayState de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0. Si se intenta establecer la propiedad displayState mientras se muestra el cuadro de diálogo de configuración, sin una respuesta de usuario, o si el atributo allowFullScreen de la etiqueta HTML param o embed no se establece como true , se emite un error de seguridad.
|
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
displayState
. Nota: debido a restricciones de seguridad, la pantalla completa sólo se puede activar en determinados casos como, por ejemplo, si el usuario ha hecho clic o presionado una tecla. Cuando se ejecuta en un navegador, la propiedad allowFullScreen se debe establecer como true.
package { import flash.display.Sprite; import flash.display.Stage; import flash.events.*; import flash.net.NetConnection; import flash.net.NetStream; import flash.media.Video; public class FullScreenExample extends Sprite { private var videoURL:String = "testVideo.flv"; private var connection:NetConnection; private var stream:NetStream; private var video:Video; public function FullScreenExample() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK,toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { switch(stage.displayState) { case "normal": stage.displayState = "fullScreen"; break; case "fullScreen": default: stage.displayState = "normal"; break; } } // Video related: private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); video = new Video(stage.stageWidth,stage.stageHeight); video.attachNetStream(stream); stream.play(videoURL); addChild(video); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } } }
focus | propiedad |
focus:InteractiveObject
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
El objeto interactivo que está seleccionado por el teclado; o null
si no se ha establecido la selección o si el objeto seleccionado pertenece a un entorno limitado de seguridad al que el objeto que origina la llamada no dispone de acceso.
Implementación
public function get focus():InteractiveObject
public function set focus(value:InteractiveObject):void
Emite
Error — Emite un error si no puede establecerse la selección para este destino.
|
Ejemplo ( Cómo utilizar este ejemplo )
myTF
para que el usuario pueda empezar a escribir sin tener que haga clic en ningún sitio. En iOS, dispositivos móviles Android y dispositivos tvOS, el usuario debe hacer clic en el campo de texto para activar el teclado virtual. Si prueba este código en la interfaz de la herramienta de edición, sólo tendrá acceso a unas pocas teclas, ya que el host (navegador o herramienta) interpreta primero las pulsaciones de tecla. Para que este ejemplo funcione como se pretende, compile y ejecute el archivo SWF.
var myTF:TextField = new TextField(); myTF.border =true; myTF.type = TextFieldType.INPUT; addChild(myTF); stage.focus= myTF;
frameRate | propiedad |
frameRate:Number
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Obtiene y establece la velocidad de fotogramas del escenario. La velocidad de fotogramas se expresa en fotogramas por segundo. De manera predeterminada, la velocidad se establece con la velocidad de fotogramas del primer archivo SWF cargado. El intervalo válido de velocidades de fotogramas es de 0,01 a 1000 fotogramas por segundo.
Nota: es posible que una aplicación no pueda seguir configuraciones altas de velocidad de fotogramas, bien porque la plataforma de destino no sea lo suficientemente rápida o porque el reproductor esté sincronizado con la temporización en blanco vertical del dispositivo de visualización (normalmente 60 Hz en dispositivos LCD). En algunos casos, una plataforma de destino puede también optar por reducir la velocidad de fotogramas máxima si prevé un uso intensivo de la CPU.
Para contenido ejecutado en Adobe AIR, configurar la propiedad frameRate
de un objeto Stage cambia la velocidad de fotogramas de todos los objetos Stage (utilizados por distintos objetos NativeWindow).
Implementación
public function get frameRate():Number
public function set frameRate(value:Number):void
Emite
SecurityError — Al llamar a la propiedad frameRate de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
fullScreenHeight | propiedad |
fullScreenHeight:uint
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Devuelve la altura del monitor que se utilizará cuando se pase al tamaño de pantalla completa, si ese estado se activa inmediatamente. Si el usuario tiene varios monitores, se emplea el que muestra la mayoría del escenario en ese momento.
Nota: si el usuario tiene la posibilidad de mover el navegador de un monitor a otro entre la recuperación del valor y el paso al tamaño de pantalla completa, el valor podría ser incorrecto. Si recupera el valor en un controlador de eventos que establece Stage.displayState
en StageDisplayState.FULL_SCREEN
, el valor será correcto.
Ésta es la altura en píxeles del monitor y es igual a la altura del escenario si Stage.align
se establece en StageAlign.TOP_LEFT
y Stage.scaleMode
en StageScaleMode.NO_SCALE
.
Implementación
public function get fullScreenHeight():uint
Elementos de API relacionados
fullScreenSourceRect
fullScreenWidth
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Ejemplo ( Cómo utilizar este ejemplo )
enterFullScreen()
, que establece la propiedad fullScreenSourceRect
y activa el modo de pantalla completa. Para establecer la propiedad fullScreenSourceRect
, el controlador de eventos comienza con la ubicación y las dimensiones del cuadrado rojo. A continuación, compara la proporción (anchura dividida entre altura) del cuadrado rojo con la proporción del escenario en pantalla completa (ancho y altura) para poder ampliar el rectángulo (fullScreenSourceRect
) y ajustarlo a la proporción de la pantalla. El resultado es que el cuadrado rojo ocupa toda la altura del monitor con el fondo verde visible a cada lado. Si no coinciden las proporciones, el color de fondo del escenario, que de manera predeterminada es blanco, se verá a cada lado en lugar del fondo verde.
Nota: pruebe este ejemplo en el navegador. En el cuadro de diálogo Configuración de publicación de Flash, en la ficha HTML, seleccione la plantilla Sólo Flash - Permitir pantalla completa. Especifique la versión de Flash Player para 9.0.115.0 y asegúrese de que se seleccionan los formatos Flash y HTML en la ficha Formatos. A continuación, publique y abra el archivo HTML resultante en el navegador.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
fullScreenSourceRect | propiedad |
fullScreenSourceRect:Rectangle
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Establece el motor de ejecución de Flash para que ajuste una región concreta en el modo de pantalla completa. Si está disponible, el motor de ejecución de Flash aplica la escala de hardware, que utiliza la tarjeta gráfica y de vídeo del equipo del usuario, con lo que normalmente muestra el contenido con mayor rapidez que con la escala de software.
Cuando esta propiedad se establece en un rectángulo válido y la propiedad displayState
se define en modo de pantalla completa, el motor de ejecución de Flash ajusta el área especificada. El tamaño real del escenario expresado en píxeles dentro de ActionScript no cambia. El motor de ejecución de Flash aplica un límite mínimo para el tamaño del rectángulo de modo que se ajuste al mensaje estándar “Press Esc to exit full-screen mode”. Este límite suele ser 260 x 30 píxeles, pero puede variar según la plataforma y la versión del motor de ejecución de Flash.
Esta propiedad sólo se puede definir cuando el motor de ejecución de Flash no está en modo de pantalla completa. Para utilizar correctamente esta propiedad, deberá establecerla primero y, después, configurar la propiedad displayState
en el modo de pantalla completa, como se muestra en los ejemplos de código. Nota: en Flash Player 15 y versiones posteriores, esta propiedad se puede definir incluso cuando el motor de ejecución de Flash está en modo de pantalla completa.
Para activar la escala, establezca la propiedad fullScreenSourceRect
en un objeto rectangle:
// valid, will enable hardware scaling stage.fullScreenSourceRect = new Rectangle(0,0,320,240);
Para desactivar la escala, establezca fullScreenSourceRect=null
en ActionScript 3.0 y undefined
en ActionScript 2.0.
stage.fullScreenSourceRect = null;
El usuario final también puede seleccionar dentro de la configuración de pantalla de Flash Player la desactivación de la escala de hardware, activada de manera predeterminada. Para más información, consulte www.adobe.com/go/display_settings_es.
Implementación
public function get fullScreenSourceRect():Rectangle
public function set fullScreenSourceRect(value:Rectangle):void
Elementos de API relacionados
Stage.displayState
Stage.scaleMode
flash.events.FullScreenEvent
flash.events.Event.RESIZE
Ejemplo ( Cómo utilizar este ejemplo )
import flash.geom.*; { stage.fullScreenSourceRect = new Rectangle(0,0,320,240); stage.displayState = StageDisplayState.FULL_SCREEN; }
Antes de utilizar el modo de pantalla completa con la escala de hardware, deben cumplirse las condiciones siguientes:
- Se necesita la versión 9.0.115.0 de Flash Player o una versión posterior, además de la herramienta de creación compatible.
- Se deben modificar las plantillas HTML para admitir la pantalla completa. El atributo
allowFullScreen
se debe establecer entrue
para las etiquetasobject
yembed
. (Los scripts que generan etiquetas que incorporan SWF también deben permitir pantalla completa.) Para obtener archivos de ejemplo que pueden utilizarse en Flash Builder, consulte el artículo Exploring full-screen mode in Flash Player 9 (Modo de pantalla completa en Flash Player 9, en inglés). - Su aplicación debe tener permiso y acceso a un archivo de vídeo FLV. En este ejemplo, se asume que el archivo de vídeo Flash (FLV) se encuentra en el mismo directorio que el archivo SWF.
- El usuario debe permitir el acceso a pantalla completa.
- Para obtener más información sobre la adaptabilidad del hardware, consulte el artículo Compatibilidad de Flash Player con vídeo de alta definición H.264 y audio AAC de Flash Player.
Se carga un archivo FLV mediante los objetos NetConnection y NetStream. Dado que el archivo FLV está en el mismo directorio que el archivo SWF y se conectará a través de HTTP, el parámetro del método NetConnection.connect()
se establece en null
. El objeto connect
NetConnection informa de su estado al distribuir un evento netStatus
que invoca el método netStatusHandler()
. El método netStatusHandler()
comprueba si la conexión se realizó con éxito e invoca el método connectStream()
, que crea un objeto NetStream que adopta el objeto NetConnection como parámetro. También crea un objeto video y le asocia el objeto NetStream. A continuación, se añade el objeto video a la lista de visualización y se establece el flujo para que se reproduzca. Dado que el archivo de vídeo FLV no contiene información de metadatos ni de puntos de referencia, se distribuirá un evento AsyncError
. Se debe configurar un detector para controlar el evento. En este caso, se configura el detector y se omite el evento. También se configura otro detector del evento netStatus
para el objeto NetStream. Mostrará un mensaje de error si no se ha encontrado el flujo. (Tenga en cuenta que se podría utilizar netStatusHandler()
para controlar un número cualquiera de datos de diferentes estados registrados para el flujo o la conexión.)
Cuando las propiedades y métodos de un archivo SWF cargado son accesibles, se invoca el método createMouseListener()
. Configura un detector de eventos para cuando se hace clic con el ratón en el escenario. El método toggleFullScreen()
comprueba si el estado de visualización está en modo de pantalla completa o normal. Si es normal, el tamaño del objeto video se establece con el tamaño del flujo de vídeo. La propiedad fullScreenSourceRect
se establece en un rectángulo que coincide con las dimensiones del objeto video. A continuación, la propiedad Stage.displayMode
se establece en pantalla completa, lo que produce que el vídeo del rectángulo de origen se expanda para llenar el área de pantalla completa. Si se cumplen los requisitos del sistema, se utilizará el hardware de gráficos del equipo para mejorar el rendimiento de la representación de vídeo en pantalla completa y se establecerá el estado de visualización en modo de pantalla completa. Para capturar cualquier error de seguridad que pudiese ocurrir mientras se cambia al modo de pantalla completa, se utiliza try...catch
. (Tenga en cuenta que el estado de visualización se debe establecer en el modo de pantalla completa después de definir la propiedad fullScreenSourceRect
.) Antes de cambiar al modo de pantalla normal, la anchura y altura del objeto video se establecen de nuevo con los valores del objeto video original guardado. De lo contrario, los cambios realizados en el objeto video para el modo de pantalla completa determinarán la anchura y altura.
package { import flash.display.Sprite; import flash.display.StageDisplayState; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; import flash.events.NetStatusEvent; import flash.events.AsyncErrorEvent; import flash.events.SecurityErrorEvent; import flash.events.MouseEvent; import flash.events.Event; import flash.geom.Rectangle; public class Stage_fullScreenSourceRectExample2 extends Sprite { private var videoURL:String = "testVideo1.flv"; private var connection:NetConnection; private var stream:NetStream; private var myVideo:Video; private var savedWidth:uint; private var savedHeight:uint; public function Stage_fullScreenSourceRectExample2() { connection = new NetConnection(); connection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); connection.addEventListener(SecurityErrorEvent.SECURITY_ERROR, securityErrorHandler); connection.connect(null); loaderInfo.addEventListener(Event.INIT, createMouseListener); } private function createMouseListener(event:Event):void { stage.addEventListener(MouseEvent.CLICK, toggleFullScreen); } private function toggleFullScreen(event:MouseEvent):void { if(stage.displayState == StageDisplayState.NORMAL) { myVideo.width = myVideo.videoWidth; myVideo.height = myVideo.videoHeight; try { stage.fullScreenSourceRect = new Rectangle(myVideo.x, myVideo.y, myVideo.width, myVideo.height); stage.displayState = StageDisplayState.FULL_SCREEN; } catch (e:SecurityError) { trace ("A security error occurred while switching to full screen: " + event); myVideo.width = savedWidth; myVideo.height = savedHeight; } }else { myVideo.width = savedWidth; myVideo.height = savedHeight; stage.displayState = StageDisplayState.NORMAL; } } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace ("Unable to locate video: " + videoURL); break; } } private function connectStream():void { var stream:NetStream = new NetStream(connection); stream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); stream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); myVideo = new Video(); myVideo.attachNetStream(stream); stream.play(videoURL); savedWidth = myVideo.width; savedHeight = myVideo.height; addChild(myVideo); } private function securityErrorHandler(event:SecurityErrorEvent):void { trace("securityErrorHandler: " + event); } private function asyncErrorHandler(event:AsyncErrorEvent):void { } } }
fullScreenWidth | propiedad |
fullScreenWidth:uint
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4 |
Devuelve la anchura del monitor que se utilizará cuando se pase al tamaño de pantalla completa, si ese estado se activa inmediatamente. Si el usuario tiene varios monitores, se emplea el que muestra la mayoría del escenario en ese momento.
Nota: si el usuario tiene la posibilidad de mover el navegador de un monitor a otro entre la recuperación del valor y el paso al tamaño de pantalla completa, el valor podría ser incorrecto. Si recupera el valor en un controlador de eventos que establece Stage.displayState
en StageDisplayState.FULL_SCREEN
, el valor será correcto.
Éste es la anchura en píxeles del monitor y es igual al ancho del escenario si Stage.align
se establece en StageAlign.TOP_LEFT
y Stage.scaleMode
en StageScaleMode.NO_SCALE
.
Implementación
public function get fullScreenWidth():uint
Elementos de API relacionados
fullScreenHeight
fullScreenSourceRect
scaleMode
StageDisplayState
flash.events.Event.RESIZE
flash.events.FullScreenEvent
Ejemplo ( Cómo utilizar este ejemplo )
enterFullScreen()
, que establece la propiedad fullScreenSourceRect
y activa el modo de pantalla completa. Para establecer la propiedad fullScreenSourceRect
, el controlador de eventos comienza con la ubicación y las dimensiones del cuadrado rojo. A continuación, compara la proporción (anchura dividida entre altura) del cuadrado rojo con la proporción del escenario en pantalla completa (ancho y altura) para poder ampliar el rectángulo (fullScreenSourceRect
) y ajustarlo a la proporción de la pantalla. El resultado es que el cuadrado rojo ocupa toda la altura del monitor con el fondo verde visible a cada lado. Si no coinciden las proporciones, el color de fondo del escenario, que de manera predeterminada es blanco, se verá a cada lado en lugar del fondo verde.
Nota: pruebe este ejemplo en el navegador. En el cuadro de diálogo Configuración de publicación de Flash, en la ficha HTML, seleccione la plantilla Sólo Flash - Permitir pantalla completa. Especifique la versión de Flash Player para 9.0.115.0 y asegúrese de que se seleccionan los formatos Flash y HTML en la ficha Formatos. A continuación, publique y abra el archivo HTML resultante en el navegador.
import flash.display.Sprite; import flash.display.Stage; import flash.display.StageDisplayState; import flash.events.MouseEvent; import flash.geom.Rectangle; // cover the stage with a green rectangle var greenRect:Sprite = new Sprite(); greenRect.graphics.beginFill(0x00FF00); greenRect.graphics.drawRect(0, 0, stage.stageWidth, stage.stageHeight); addChild(greenRect); // create red square on stage, turn it into a button for going to full screen var redSquare:Sprite = new Sprite(); redSquare.graphics.beginFill(0xFF0000); redSquare.graphics.drawRect(0, 0, 300, 300); redSquare.x = 50; redSquare.y = 50; redSquare.addEventListener(MouseEvent.CLICK, enterFullScreen); redSquare.buttonMode = true; addChild(redSquare); function enterFullScreen(e:MouseEvent):void { // we will go to full screen zoomed in on the red square var redSquare:Sprite = e.target as Sprite; var fullScreenRect:Rectangle = new Rectangle(redSquare.x, redSquare.y, redSquare.width, redSquare.height); // calculate aspect ratio of the red square var rectAspectRatio:Number = fullScreenRect.width / fullScreenRect.height; // calculate aspect ratio of the screen var screenAspectRatio:Number = stage.fullScreenWidth / stage.fullScreenHeight; // change the fullScreenRect so that it covers the entire screen, keeping it centered on the redSquare // try commenting out this section to see what happens if you do not fix the aspect ratio. if (rectAspectRatio > screenAspectRatio) { var newHeight:Number = fullScreenRect.width / screenAspectRatio; fullScreenRect.y -= ((newHeight - fullScreenRect.height) / 2); fullScreenRect.height = newHeight; } else if (rectAspectRatio < screenAspectRatio) { var newWidth:Number = fullScreenRect.height * screenAspectRatio; fullScreenRect.x -= ((newWidth - fullScreenRect.width) / 2); fullScreenRect.width = newWidth; } // go to full screen stage.fullScreenSourceRect = fullScreenRect; stage.displayState = StageDisplayState.FULL_SCREEN; }
height | propiedad |
height:Number
[override] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica la altura del objeto de visualización, expresada en píxeles. La anchura se calcula según los límites del contenido del objeto de visualización. Cuando define la propiedad height
, la propiedad scaleY
se ajusta en consecuencia, tal y como se muestra en el siguiente código:
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleY) // 1; rect.height = 200; trace(rect.scaleY) // 2;
Excepto en lo que respecta a los objetos TextField y Video, un objeto de visualización sin contenido (como un sprite vacío) tiene una altura de 0, incluso si intenta definir height
en un valor diferente.
Implementación
override public function get height():Number
override public function set height(value:Number):void
Emite
SecurityError — Al hacer referencia a la propiedad height de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
| |
IllegalOperationError — Nunca se permite establecer la propiedad height de un objeto Stage, incluso en el caso de que el objeto que origina la llamada sea el propietario del objeto Stage (el archivo SWF principal).
|
mouseChildren | propiedad |
mouseChildren:Boolean
[override] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina si los elementos secundarios del objeto están activados para acciones de ratón o de dispositivo de entrada de usuario. Si un objeto está activado, el usuario puede interactuar con él por medio de un ratón o de un dispositivo de entrada de usuario. El valor predeterminado es true
.
Esta propiedad es útil cuando se crea un botón con una instancia de la clase Sprite (en lugar de utilizar la clase SimpleButton). Cuando utilice una instancia de Sprite para crear un botón, podrá optar por decorar el botón empleando el método addChild()
para añadir instancias adicionales de Sprite. Este proceso puede provocar un comportamiento inesperado con los eventos de ratón, ya que las instancias de Sprite que añada como elementos secundarios pueden convertirse en el objeto de destino de un evento de ratón cuando se espera que la instancia principal sea el objeto de destino. Para asegurarse de que la instancia principal actúa como objeto de destino de los eventos de ratón, puede establecer la propiedad mouseChildren
de la instancia principal con el valor false
.
No se distribuye ningún evento al establecer esta propiedad. Debe utilizar el método addEventListener()
para crear funcionalidad interactiva.
Implementación
override public function get mouseChildren():Boolean
override public function set mouseChildren(value:Boolean):void
Emite
SecurityError — Al hacer referencia a la propiedad mouseChildren de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
mouseLock | propiedad |
mouseLock:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11.2, AIR 3.2 |
Establézcalo como true
para activar el bloqueo del ratón. Activar el bloqueo el ratón desactiva el cursor y permite el movimiento ilimitado del ratón. Sólo es posible activar el bloqueo del ratón en el modo de pantalla completa en las aplicaciones para escritorio. Si se activa cuando no se está en modo de pantalla completa, o en aplicaciones para dispositivos móviles, se emitirá una excepción.
El bloqueo del ratón se desactiva automáticamente y el cursor del ratón se hace de nuevo visible cuando:
- El usuario sale del modo de pantalla completa mediante el uso de las teclas Esc (todas las plataformas), Control-W (Windows), Comando-W (Mac) o Alt-F4 (Windows).
- La ventana de la aplicación deja de estar seleccionada.
- Cualquier interfaz de configuración es visible, incluidos todos los cuadros de diálogo de privacidad.
- Se visualiza un cuadro de diálogo nativo, por ejemplo, un cuadro de diálogo carga de archivos.
Al salir modo pantalla completa, esta propiedad se establece automáticamente en false
.
Los eventos asociados al movimiento del ratón, como el evento mouseMove
, utilizan la clase MouseEvent para representar al objeto de evento. Si el bloqueo del ratón está desactivado, utilice las propiedades MouseEvent.localX
y MouseEvent.localY
para determinar la ubicación del ratón. Si el bloqueo del ratón está activado , utilice las propiedades MouseEvent.movementx
y MouseEvent.movementy
para determinar la ubicación del ratón. Las propiedades movementX
y movementY
contienen cambios de posición del ratón desde el último evento, no las coordenadas absolutas de la ubicación del ratón.
Nota: cuando la aplicación está en modo de pantalla completa, no se distribuyen los detectores de eventos de ratón asociados a los objetos de visualización que no sean Stage. Por lo tanto, para recibir cualquier delta de ratón u otros eventos de ratón cuando mouseLock
es true
, asocie los detectores de eventos de ratón al objeto Stage.
Implementación
public function get mouseLock():Boolean
public function set mouseLock(value:Boolean):void
Elementos de API relacionados
nativeWindow | propiedad |
nativeWindow:NativeWindow
[solo lectura] Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Referencia al objeto NativeWindow que contiene este elemento Stage.
La ventana representa la ventana del sistema operativo nativo; el elemento Stage representa el contenido de la ventana. Esta propiedad sólo es válida para el contenido que se ejecuta en AIR con plataformas que admiten la clase NativeWindow. En otras plataformas, esta propiedad será null
. En Flash Player (contenido ejecutado en un navegador), la propiedad también es null
.
Implementación
public function get nativeWindow():NativeWindow
numChildren | propiedad |
numChildren:int
[solo lectura] [override] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Devuelve el número de elementos secundarios de este objeto.
Implementación
override public function get numChildren():int
Emite
SecurityError — Al hacer referencia a la propiedad numChildren de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
orientation | propiedad |
orientation:String
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2 |
La orientación actual del escenario. Esta propiedad se establece en uno de cuatro valores posible, definidos como constantes en la clase StageOrientation:
Constante StageOrientation | Orientación del escenario |
---|---|
StageOrientation.DEFAULT | La pantalla tiene la orientación predeterminada (derecha hacia arriba). |
StageOrientation.ROTATED_RIGHT | La pantalla está girada a la derecha. |
StageOrientation.ROTATED_LEFT | La pantalla está girada a la izquierda. |
StageOrientation.UPSIDE_DOWN | La pantalla está girada al revés. |
StageOrientation.UNKNOWN | La aplicación aún no ha determinado la orientación inicial de la pantalla. Puede añadir un detector de eventos al evento orientationChange |
Para definir la orientación del escenario, utilice el método setOrientation()
.
Importante: la propiedad orientation se admite en dispositivos Android con espacio de nombres 2.6 o posterior.
Implementación
public function get orientation():String
Elementos de API relacionados
quality | propiedad |
quality:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Valor de la clase StageQuality que especifica la calidad de representación que se utiliza. Los valores siguientes son válidos:
StageQuality.LOW
: calidad de representación baja. No se suavizan ni los gráficos ni los mapas de bits, pero los motores de ejecución siguen utilizando la asignación MIP.StageQuality.MEDIUM
: calidad de representación media. Los gráficos se suavizan empleando una cuadrícula de 2 x 2 píxeles; el suavizado de mapas de bits depende delBitmap.smoothing
. Los motores de ejecución utilizan la asignación MIP. Este ajuste resulta adecuado para películas que no incluyan texto.StageQuality.HIGH
: calidad de representación alta. Los gráficos se suavizan empleando una cuadrícula de 4 x 4 píxeles; el suavizado de mapas de bits depende del ajusteBitmap.smoothing
. Los motores de ejecución utilizan la asignación MIP. Esta es la calidad de representación predeterminada que utiliza Flash Player.StageQuality.BEST
: calidad de representación muy alta. Los gráficos se suavizan empleando una cuadrícula de 4 x 4 píxeles. SiBitmap.smoothing
estrue
, el motor de ejecución utiliza un algoritmo de reducción de escala de alta calidad que produce menos defectos (sin embargo, si se utilizaStageQuality.BEST
conBitmap.smoothing
establecido entrue
, se reduce considerablemente el rendimiento y no es un ajuste recomendado).
Una configuración de mayor calidad permite representar mejor mapas de bits a escala. Sin embargo, obtene más calidad implica consumir más recursos del equipo. En concreto, al representar vídeo a escala, el uso de una configuración de mayor calidad puede reducir la velocidad de fotogramas.
El método BitmapData.draw()
utiliza el valor de la propiedad Stage.quality
. Como alternativa, se puede utilizar el método BitmapData.drawWithQuality()
, que permite especificar el parámetro quality
en el método, ignorando el valor actual de Stage.quality
.
En el perfil de escritorio de Adobe AIR, quality
se puede establecer como StageQuality.BEST
o StageQuality.HIGH
(el valor predeterminado es StageQuality.HIGH
). Intentar establecer cualquier otro valor no produce ningún efecto (y la propiedad no cambia). En perfil móvil de AIR, los cuatro ajustes de calidad están disponibles. El valor predeterminado en dispositivos móviles es StageQuality.MEDIUM
.
Para contenido ejecutado en Adobe AIR, configurar la propiedad quality
de un objeto Stage cambia la calidad de representación de todos los objetos Stage (utilizados por distintos objetos NativeWindow).
quality
.
Implementación
public function get quality():String
public function set quality(value:String):void
Emite
SecurityError — Al llamar a la propiedad quality de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
Elementos de API relacionados
scaleMode | propiedad |
scaleMode:String
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Un valor de la clase StageScaleMode que especifica el modo de escala que debe utilizarse. Los valores siguientes son válidos:
StageScaleMode.EXACT_FIT
: hace que esté visible toda la aplicación en el área especificada sin intentar mantener la proporción original. Puede producirse cierta distorsión y la aplicación tal vez se visualice estirada o comprimida.StageScaleMode.SHOW_ALL
: permite ver toda la aplicación en el área especificada sin distorsión, al tiempo que mantiene la proporción original de la aplicación. Es posible que aparezcan bordes a ambos lados de la aplicación.StageScaleMode.NO_BORDER
: toda la aplicación completa ocupa el área especificada, sin distorsión pero quizá con algún recorte, mientras se mantiene la proporción original de la aplicación.StageScaleMode.NO_SCALE
: la aplicación completa queda fija, de manera que permanezca sin cambios aunque cambie el tamaño de la ventana del reproductor. Puede producirse un recorte si la ventana del reproductor es más pequeña que el contenido.
Implementación
public function get scaleMode():String
public function set scaleMode(value:String):void
Emite
SecurityError — Al llamar a la propiedad scaleMode de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
Elementos de API relacionados
showDefaultContextMenu | propiedad |
showDefaultContextMenu:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Especifica si deben mostrarse u ocultarse los elementos predeterminados del menú contextual del motor de ejecución de Flash.
Si la propiedad showDefaultContextMenu
se establece con el valor true
(que es el valor predeterminado), aparecerán todos los elementos del menú contextual. Si la propiedad showDefaultContextMenu
se establece con el valor false
, sólo aparecerán los elementos de menú Configuración y Acerca de...
Implementación
public function get showDefaultContextMenu():Boolean
public function set showDefaultContextMenu(value:Boolean):void
Emite
SecurityError — Al llamar a la propiedad showDefaultContextMenu de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
softKeyboardRect | propiedad |
softKeyboardRect:Rectangle
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.6, Flash Player 10.2 |
Un objeto Rectangle que especifica el área del escenario actualmente ocupada por un teclado en pantalla. Los componentes de Rect son (0,0,0,0) cuando el teclado virtual no está visible.
Implementación
public function get softKeyboardRect():Rectangle
Elementos de API relacionados
stage3Ds | propiedad |
stage3Ds:Vector.<Stage3D>
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 11, AIR 3 |
Una lista de objetos Stage3D disponibles para mostrar contenido tridimensional.
Sólo se puede utilizar un número limitado de objetos Stage3D a la vez. El número de objetos Stage3D disponibles depende de la plataforma y del hardware disponible.
Un objeto Stage3D dibuja delante de un objeto StageVideo y detrás de la lista de visualización de Flash.
Implementación
public function get stage3Ds():Vector.<Stage3D>
Elementos de API relacionados
stageFocusRect | propiedad |
stageFocusRect:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica si los objetos deben mostrar un borde brillante cuando están seleccionados.
Implementación
public function get stageFocusRect():Boolean
public function set stageFocusRect(value:Boolean):void
Emite
SecurityError — Al llamar a la propiedad stageFocusRect de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
stageHeight | propiedad |
stageHeight:int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La altura actual del escenario en píxeles.
Si el valor de la propiedad Stage.scaleMode
se establece en StageScaleMode.NO_SCALE
cuando el usuario cambia de tamaño la ventana, el contenido del escenario conserva su tamaño definido, mientras que la propiedad stageHeight
cambia para reflejar la nueva altura del área de la pantalla oupada por el archivo SWF. (En el resto de modos de escala, la propiedad stageHeight
siempre refleja la altura original del archivo SWF.) Puede añadir un detector de eventos al evento resize
y utilizar la propiedad stageHeight
de la clase Stage para determinar las dimensiones reales en píxeles de la ventana del motor de ejecución de Flash que ha cambiado de tamaño. El detector de eventos permite controlar el ajuste del contenido de la pantalla cuando el usuario modifica el tamaño.
Los dispositivos de AIR para TV tienen un comportamiento ligeramente distinto que los dispositivos de escritorio cuando se establece la propiedad stageHeight
. Si la propiedad escenario.scaleMode
se establece en StageScaleMode.NO_SCALE
y define la propiedad stageHeight
, la altura del escenario no cambia hasta el fotograma siguiente de del SWF.
Nota: en la página HTML que aloja el archivo SWF, los atributos height
de las etiquetas de object
y embed
deben establecerse como porcentaje (por ejemplo, 100%
), no en píxeles. Si la configuración se genera con código JavaScript, el parámetro height
del método AC_FL_RunContent()
también debe establecerse como porcentaje. Este porcentaje se aplica al valor stageHeight
Implementación
public function get stageHeight():int
public function set stageHeight(value:int):void
Emite
SecurityError — Al llamar a la propiedad stageHeight de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
Elementos de API relacionados
stageVideos | propiedad |
stageVideos:Vector.<StageVideo>
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.5, Flash Player 10.2 |
Una lista de objetos StageVideo disponibles para reproducir vídeos externos.
Se puede utilizar sólo un número limitado de objetos StageVideo a la vez. Cuando se comienza a ejecutar un SWF, el número de objetos StageVideo depende de la plataforma y hardware disponible.
Para utilizar un objeto StageVideo, asigne un miembro del objeto vectorial stageVideos
y una variable StageVideo.
Todos los objetos StageVideo se visualizan en el escenario detrás de cualquier objeto de visualización. Los objetos StageVideo se visualizan en el escenario en el orden en que aparecen en el objeto vectorial stageVideos
. Por ejemplo, si el objeto vectorial stageVideos
contiene tres entradas:
- El objeto StageVideo en el índice de 0 del objeto vectorial
stageVideos
se muestra detrás de todos los objetos StageVideo. - El objeto StageVideo en el índice 1 se muestra delante del objeto StageVideo en el índice 0.
- El objeto StageVideo en el índice 2 se muestra delante del objeto StageVideo en el índice 1.
Utilice la propiedad StageVideo.depth
para cambiar esta ordenación.
Nota: los dispositivos de AIR para TV admiten solo un objeto StageVideo.
Implementación
public function get stageVideos():Vector.<StageVideo>
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
var stageVideo:StageVideo; if ( stage.stageVideos.length >= 1 ) { stageVideo = stage.stageVideos[0]; }
stageWidth | propiedad |
stageWidth:int
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica la anchura actual del escenario en píxeles.
Si el valor de la propiedad Stage.scaleMode
se establece en StageScaleMode.NO_SCALE
cuando el usuario cambia de tamaño la ventana, el contenido del escenario conserva su tamaño definido, mientras que la propiedad stageWidth
cambia para reflejar la nueva anchura del área de la pantalla oupada por el archivo SWF. (En el resto de modos de escala, la propiedad stageWidth
siempre refleja la anchura original del archivo SWF.) Puede añadir un detector de eventos al evento resize
y utilizar la propiedad stageWidth
de la clase Stage para determinar las dimensiones reales en píxeles de la ventana del motor de ejecución de Flash que ha cambiado de tamaño. El detector de eventos permite controlar el ajuste del contenido de la pantalla cuando el usuario modifica el tamaño.
Los dispositivos de AIR para TV tienen un comportamiento ligeramente distinto que los dispositivos de escritorio cuando se establece la propiedad stageWidth
. Si la propiedad Stage.scaleMode
se establece en StageScaleMode.NO_SCALE
y define la propiedad stageWidth
, la anchura del escenario no cambia hasta el fotograma siguiente del SWF.
Nota: en la página HTML que aloja el archivo SWF, los atributos width
de las etiquetas de object
y embed
deben establecerse como porcentaje (por ejemplo, 100%
), no en píxeles. Si la configuración se genera con código JavaScript, el parámetro width
del método AC_FL_RunContent()
también debe establecerse como porcentaje. Este porcentaje se aplica al valor stageWidth
.
Implementación
public function get stageWidth():int
public function set stageWidth(value:int):void
Emite
SecurityError — Al llamar a la propiedad stageWidth de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
Elementos de API relacionados
supportedOrientations | propiedad |
supportedOrientations:Vector.<String>
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.6 |
Las orientaciones admitidas por el dispositivo actual.
Se pueden utilizar las cadenas de orientación incluidas en esta lista como parámetros para el método setOrientation()
. La definición de una orientación no admitida siempre producirá un error.
Las posibles orientaciones incluyen:
Constante StageOrientation | Orientación del escenario |
---|---|
StageOrientation.DEFAULT | Establece la orientación del escenario en la orientación predeterminada (derecha hacia arriba). |
StageOrientation.ROTATED_RIGHT | Establece la orientación el escenario girada a la derecha. |
StageOrientation.ROTATED_LEFT | Establece la orientación el escenario girada a la izquierda. |
StageOrientation.UPSIDE_DOWN | Establece la orientación el escenario girada al revés. |
Implementación
public function get supportedOrientations():Vector.<String>
Elementos de API relacionados
supportsOrientationChange | propiedad |
supportsOrientationChange:Boolean
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2 |
Si la aplicación admite cambios en la orientación del escenario (y rotación de dispositivo) En la actualidad, esta propiedad sólo es true
en aplicaciones de AIR que se ejecutan en dispositivos móviles.
Implementación
public static function get supportsOrientationChange():Boolean
Elementos de API relacionados
tabChildren | propiedad |
tabChildren:Boolean
[override] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Determina si los elementos secundarios del objeto están habilitados para tabulación. Activa o desactiva la tabulación para los elementos secundarios del objeto. El valor predeterminado es true
.
Nota: no se debe utilizar la propiedad tabChildren
con Flex. En su lugar, utilice la propiedad mx.core.UIComponent.hasFocusableChildren
.
Implementación
override public function get tabChildren():Boolean
override public function set tabChildren(value:Boolean):void
Emite
SecurityError — Al hacer referencia a la propiedad tabChildren de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
textSnapshot | propiedad |
textSnapshot:flash.text:TextSnapshot
[solo lectura] [override] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Devuelve un objeto TextSnapshot para esta instancia de DisplayObjectContainer.
Implementación
override public function get textSnapshot():flash.text:TextSnapshot
Emite
IllegalOperationError — Al hacer referencia a la propiedad textSnapshot de un objeto Stage, se emite una excepción, ya que la clase Stage no implementa esta propiedad. Para evitar esto, llame a la propiedad textSnapshot de un contenedor de objeto de visualización que no sea el objeto Stage.
|
vsyncEnabled | propiedad |
vsyncEnabled:Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 29.0 |
Esto representa el estado actual de la propiedad vsync de la solución de gráficos subyacente. Se puede activar o desactivar vsync, por lo que se procesaría inmediatamente sin tener que esperar al siguiente estado de VSYNC. La lectura de la propiedad es válida en cualquier momento. Sin embargo, se permite la configuración de la propiedad únicamente después de activar VsyncStateChangeAvailabilityEvent.
Implementación
public function get vsyncEnabled():Boolean
public function set vsyncEnabled(value:Boolean):void
width | propiedad |
width:Number
[override] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Indica la anchura del objeto de visualización, expresada en píxeles. La anchura se calcula según los límites del contenido del objeto de visualización. Cuando define la propiedad width
, la propiedad scaleX
se ajusta en consecuencia, tal y como se muestra en el siguiente código:
var rect:Shape = new Shape(); rect.graphics.beginFill(0xFF0000); rect.graphics.drawRect(0, 0, 100, 100); trace(rect.scaleX) // 1; rect.width = 200; trace(rect.scaleX) // 2;
Excepto en lo que respecta a los objetos TextField y Video, un objeto de visualización sin contenido (como un sprite vacío) tiene una anchura de 0, incluso si intenta definir width
en un valor diferente.
Implementación
override public function get width():Number
override public function set width(value:Number):void
Emite
SecurityError — Al hacer referencia a la propiedad width de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
| |
IllegalOperationError — Nunca se permite establecer la propiedad width de un objeto Stage, incluso en el caso de que usted sea el propietario del objeto Stage.
|
wmodeGPU | propiedad |
wmodeGPU:Boolean
[solo lectura] Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | Flash Player 10.0.32, AIR 1.5.2, Flash Lite 4 |
Indica si está disponible composición con GPU y si está en uso. El valor wmodeGPU
es true
sólo si se presenta una de las tres situaciones siguientes:
- Se ha solicitado la composición con GPU.
- Está disponible la composición con GPU.
- La composición con GPU está en uso.
En concreto, la propiedad wmodeGPU
indica una de las acciones siguientes:
- La composición con GPU no se ha solicitado o no está disponible. En ese caso, el valor de la propiedad
wmodeGPU
esfalse
. - Se ha solicitado la composición con GPU (si procede y está disponible), pero el entorno está en el “modo repuesto” (el procesamiento no es el óptimo) debido a las limitaciones del contenido. En ese caso, el valor de la propiedad
wmodeGPU
estrue
. - Se ha solicitado la composición con GPU (si procede y está disponible) y el entorno funciona en el mejor modo. En ese caso, el valor de la propiedad
wmodeGPU
también estrue
.
Dicho de otro modo, la propiedad wmodeGPU
identifica la capacidad y el estado del entorno de procesamiento. Para motores de ejecución que no admiten composición con GPU, tales como AIR 1.5.2, el valor siempre es false
porque (como hemos indicado anteriormente) el valor sólo es true
cuando se ha solicitado la composición con GPU, está disponible y está en uso.
La propiedad wmodeGPU
resulta útil para determinar, en tiempo de ejecución, si la composición con GPU está o no en uso. El valor de wmodeGPU
indica si el contenido se van a escalar con el hardware o no, por lo que se pueden presentar gráficos con el tamaño correcto. También puede determinar si el procesamiento es rápido o no, para que pueda ajustar la complejidad del contenido en consecuencia.
Para Flash Player en un navegador, la composición con GPU se puede solicitar mediante el valor gpu
para el parámetro HTML wmode
de la página que aloja el archivo SWF. En otras configuraciones, la composición con GPU puede solicitarse en el encabezado de un archivo SWF (establecido con herramientas de edición SWF).
Sin embargo, la propiedad wmodeGPU
no identifica el rendimiento actual del procesamiento. Incluso si composición con GPU está “en uso”, es posible que el procesamiento no funcione del mejor modo. Para ajustar el contenido a un procesamiento óptimo, utilice una versión del motor de ejecución de Flash y establezca DisplayGPUBlendsetting
en su archivo mm.cfg.
Nota: esta propiedad siempre es false
cuando se hace referencia a ella desde código ActionScript que se ejecuta antes de que el motor de ejecución realice su primer ciclo de procesamiento. Por ejemplo, si examina wmodeGPU
desde un script en el fotograma 1 de Adobe Flash Professional y el archivo SWF es el primer archivo SWF cargado en una nueva instancia del motor de ejecución, el valor de wmodeGPU
será false
. Para obtener un valor preciso, espere al menos hasta que se haya llevado a cabo un procesamiento. Si escribe un detector de eventos para el evento exitFrame
de cualquier objeto DisplayObject
, el valor de wmodeGPU
será el valor correcto.
Implementación
public function get wmodeGPU():Boolean
Elementos de API relacionados
Ejemplo ( Cómo utilizar este ejemplo )
wmodeGPU
después de que el objeto de visualización mySprite se procesa, por lo que puede obtener un valor preciso.
mySprite.addEventListener(EXIT_FRAME, exithandler): function exithandler(exiteventobject:Event):void { trace(stage.wmodeGPU); }
addChild | () | método |
override public function addChild(child:DisplayObject):DisplayObject
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer. El elemento secundario se añade delante (encima) de todos los demás elementos secundarios de esta instancia de DisplayObjectContainer. (Para añadir un elemento secundario en una posición de índice concreta, utilice el método addChildAt()
.)
Si añade un objeto secundario que ya tiene un contenedor de objeto de visualización diferente como elemento principal, el objeto se elimina de la lista de elementos secundarios del otro contenedor de objeto de visualización.
Nota: el comando stage.addChild()
puede causar problemas en un archivo SWF publicado, incluidos problemas de seguridad y conflictos con otros archivos SWF cargados. Sólo hay un escenario dentro de una instancia del motor de ejecución de Flash, no importa la cantidad archivos SWF cargados en el motor de ejecución. Por lo tanto, normalmente los objetos no se deben añadir al escenario directamente, bajo ningún concepto. El único objeto que debe contener el escenario es el objeto raíz. Cree un objeto DisplayObjectContainer para contener todos los elementos de la lista de visualización. Seguidamente, si es necesario, añada la instancia de DisplayObjectContainer al escenario.
Parámetros
child:DisplayObject — La instancia de DisplayObject que se va a añadir como elemento secundario de esta instancia de DisplayObjectContainer.
|
DisplayObject — La instancia de DisplayObject que se pasa en el parámetro child .
|
Emite
SecurityError — Al llamar al método addChild() de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
addChildAt | () | método |
override public function addChildAt(child:DisplayObject, index:int):DisplayObject
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Añade una instancia secundaria de DisplayObject a esta instancia de DisplayObjectContainer. El elemento secundario situado en la posición de índice especificada. El índice 0 representa el final (la parte inferior) de la lista de visualización de este objeto DisplayObjectContainer.
Por ejemplo, el siguiente ejemplo muestra tres objetos de visualización, etiquetados como a, b y c, en las posiciones de índice 0, 2 y 1 respectivamente:
Si añade un objeto secundario que ya tiene un contenedor de objeto de visualización diferente como elemento principal, el objeto se elimina de la lista de elementos secundarios del otro contenedor de objeto de visualización.
Parámetros
child:DisplayObject — La instancia de DisplayObject que se va a añadir como elemento secundario de esta instancia de DisplayObjectContainer.
| |
index:int — Posición de índice en la que se añade el elemento secundario. Si especifica una posición de índice actualmente ocupada, el objeto secundario que hay en dicha posición y todas las posiciones superiores suben una posición en la lista de elementos secundarios.
|
DisplayObject — La instancia de DisplayObject que se pasa en el parámetro child .
|
Emite
SecurityError — Al llamar al método addChildAt() de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
addEventListener | () | método |
override public function addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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 ) —
Determina si el detector funciona en la fase de captura o en las fases de destino y de propagación. Si 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 ) — El nivel de prioridad del detector de eventos. La prioridad viene designada por un entero de 32 bits sin signo. Cuanto mayor sea el número, mayor será la prioridad. Todos los detectores con prioridad n se procesan antes que los detectores con prioridad n-1. Si dos o más detectores comparten la misma prioridad, se procesarán en el orden en el que se añadieron. La prioridad predeterminada es 0.
| |
useWeakReference:Boolean (default = false ) — Determina si la referencia al detector es fuerte o débil. Una referencia fuerte (valor predeterminado) impide que el detector sea eliminado por el recolector de datos innecesarios. Una referencia débil no lo hace. Las funciones de miembros de clase no están sujetas a la recolección de elementos no utilizados, por lo que |
Emite
SecurityError — Al llamar al método addEventListener de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esta situación, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
assignFocus | () | método |
public function assignFocus(objectToFocus:InteractiveObject, direction:String):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0 |
Establece la selección del teclado en el objeto interactivo especificado por objectToFocus
, con al dirección de selección especificada por el parámetro direction
.
El concepto de la dirección de selección se debe definir en la aplicación (o en el marco de trabajo de la aplicación). No existe ninguna ordenación intrínseca de los objetos interactivos, aunque se pueden utilizar otras propiedades disponibles para establecer un orden. Por ejemplo, se pueden ordenar los objetos interactivos por su posición en el escenario o en la lista de visualización. Llamar a assignFocus()
equivale a establecer la propiedad Stage.focus
, con la posibilidad adicional de indicar la dirección desde la que se define la selección.
objectToFocus
distribuye un evento focusIn
al recibir la selección. La propiedad direction
del objeto FocusEvent informa sobre la configuración del parámetro direction
.
Si asigna un objeto HTMLLoader al parámetro objectToFocus
, el objeto HTMLLoader selecciona el objeto seleccionable adecuado en el DOM HTML en función del valor del parámetro direction
. Si es FocusDirection.BOTTOM
, se selecciona el objeto seleccionable del DOM HTML situado al final del orden de lectura. Si es FocusDirection.TOP
, se selecciona el objeto seleccionable del DOM HTML situado al principio del orden de lectura. Si es NONE
, el objeto HTMLLoader recibe la selección sin cambiar su elemento seleccionado actual.
Parámetros
objectToFocus:InteractiveObject — Objeto que se va a seleccionar, o null para borrar la selección de cualquier elemento del escenario.
| |
direction:String — Dirección desde la que se selecciona objectToFocus . Los valores válidos se enumeran como constantes de la clase FocusDirection.
|
Emite
Error — Si no se puede establecer la selección en el destino o si la dirección no es del tipo válido.
|
Elementos de API relacionados
dispatchEvent | () | método |
override public function dispatchEvent(event:Event):Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
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.
|
Emite
SecurityError — Al llamar al método dispatchEvent() de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
hasEventListener | () | método |
override public function hasEventListener(type:String):Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. De este modo, es posible determinar en qué lugar de la jerarquía del flujo del evento un objeto EventDispatcher ha alterado el control de un tipo de evento. Para determinar si un tipo de evento concreto realmente desencadena un detector de eventos, utilice willTrigger()
.
La diferencia entre hasEventListener()
y willTrigger()
reside en que hasEventListener()
examina sólo el objeto al que pertenece, mientras que willTrigger()
examina todo el flujo del evento especificado por el parámetro type
.
Si se llama a hasEventListener()
desde un objeto LoaderInfo, sólo se tendrán en cuenta los detectores a los que puede acceder el que origina la llamada.
Parámetros
type:String — El tipo de evento.
|
Boolean — Un valor true si está registrado un detector del tipo especificado; false en caso contrario.
|
Emite
SecurityError — Al llamar al método hasEventListener() de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
invalidate | () | método |
public function invalidate():void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Al llamar al método invalidate()
, se indica a los motores de ejecución de Flash que avisen a los objetos de visualización de la próxima oportunidad que tendrán para representar la lista de visualización (por ejemplo, cuando la cabeza lectora avanza a un nuevo fotograma). Tras llamar al método invalidate()
, cuando la lista de visualización se vuelva a representar, el motor de ejecución de Flash enviará un evento render
a cada objeto de visualización que se haya registrado para detectar el evento render
. Debe llamar al método invalidate()
cada vez que desee que el motor de ejecución de Flash envíe eventos render
.
El evento render
le da la oportunidad de realizar cambios en la lista de visualización inmediatamente antes de que se muestre. Esto le permite retrasar las actualizaciones de la lista de visualización hasta la oportunidad más reciente. Esto puede aumentar el rendimiento al eliminar actualizaciones de pantalla innecesarias.
El evento render
sólo se distribuye para mostrar objetos que están en el mismo dominio de seguridad que le código que llama al método stage.invalidate()
o para mostrar objetos de un dominio de seguridad al que se ha concedido permiso a través del método Security.allowDomain()
.
Elementos de API relacionados
isFocusInaccessible | () | método |
public function isFocusInaccessible():Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Determina si la propiedad Stage.focus
devuelve null
por motivos de seguridad. Dicho de otro modo, isFocusInaccessible
devuelve true
si el objeto que está seleccionado pertenece a un entorno limitado de seguridad al que no tiene acceso el archivo SWF.
Boolean — true si el objeto que está seleccionado pertenece a un entorno limitado de seguridad al que no tiene acceso el archivo SWF.
|
removeChildAt | () | método |
override public function removeChildAt(index:int):DisplayObject
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Elimina una instancia de DisplayObject secundaria de la posición de index
especificada en la lista de elementos secundarios de DisplayObjectContainer. La propiedad parent
del elemento secundario eliminado se establece como null
y el objeto se recoge como dato innecesario si no hay ninguna otra referencia al elemento secundario. La posición de índice de los objetos de visualización situados por encima del elemento secundario en DisplayObjectContainer se reduce en 1.
La eliminación de datos innecesarios rescata espacio de memoria no utilizado. Cuando deja de haber una referencia activa o un almacenamiento de una variable o un objeto en algún lugar, la recogida de datos innecesarios limpia el espacio de memoria que ocupaba si no hay ninguna otra referencia a estos.
Parámetros
index:int — El índice secundario de la instancia de DisplayObject que se va a eliminar.
|
DisplayObject — La instancia de DisplayObject que se eliminó.
|
Emite
SecurityError — Al llamar al método removeChildAt() de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el objeto que se va a eliminar. Para evitar esto, el propietario de ese objeto puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
setAspectRatio | () | método |
public function setAspectRatio(newAspectRatio:String):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2 |
Establece la orientación del escenario según la relación de aspecto especificada.
Si la orientación del escenario cambia como resultado de la llamada al método, el objeto Stage distribuye un evento orientationChange.
Para comprobar si se admite la orientación de dispositivo, compruebe el valor de la propiedad Stage.supportsOrientantionChange
.
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. Puede comprobar la compatibilidad en tiempo de ejecución mediante la propiedad Stage.supportsOrientantionChange
. Consulte Compatibilidad con perfil de AIR para obtener información sobre la compatibilidad de la API con varios perfiles.
Parámetros
newAspectRatio:String — El código de la relación de aspecto deseada (StageAspectRatio.PORTRAIT , StageAspectRatio.LANDSCAPE o StageAspectRatio.ANY ).
|
Emite
ArgumentError — El valor transferido como parámetro newAspectRatio no es válido. El valor debe coincidir con una de las constantes definidas en la clase StageAspectRatio.
|
Elementos de API relacionados
setChildIndex | () | método |
override public function setChildIndex(child:DisplayObject, index:int):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Cambia la posición de un elemento secundario existente en el contendor de objeto de visualización. Esto afecta a la disposición en capas de los objetos secundarios. Por ejemplo, el siguiente ejemplo muestra tres objetos de visualización, etiquetados como a, b y c, en las posiciones de índice 0, 1 y 2 respectivamente:
Cuando se utiliza el método setChildIndex()
y se especifica una posición de índice ya ocupada, sólo se pueden cambiar las posiciones situadas entre la posición nueva y antigua de los objetos de visualización. El resto permanecen invariables. Si se mueve un elemento secundario a un índice INFERIOR que su índice actual, todos los elementos secundarios AUMENTARÁN en 1 su referencia de índice. Si se mueve un elemento secundario a un índice SUPERIOR que su índice actual, todos los elementos secundarios DISMINUIRÁN en 1 su referencia de índice. Por ejemplo, si el contenedor de objeto secundario del ejemplo anterior se denomina container
, podrá intercambiar la posición de los objetos de visualización etiquetados como a y b llamando al siguiente código:
container.setChildIndex(container.getChildAt(1), 0);
Este código da como resultado la siguiente disposición de objetos:
Parámetros
child:DisplayObject — La instancia de DisplayObject secundaria para la que desea cambiar el número de índice.
| |
index:int — El número de índice resultante para el objeto de visualización child .
|
Emite
SecurityError — Al llamar al método setChildIndex() de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
setOrientation | () | método |
public function setOrientation(newOrientation:String):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2 |
Establece el escenario con la orientación especificada.
Establece el parámetro newOrientation
en uno de los siguientes cuatro valores definidos como constantes en la clase StageOrientation:
Constante StageOrientation | Orientación del escenario |
---|---|
StageOrientation.DEFAULT | Establece la orientación del escenario en la orientación predeterminada (derecha hacia arriba). |
StageOrientation.ROTATED_RIGHT | Establece la orientación el escenario girada a la derecha. |
StageOrientation.ROTATED_LEFT | Establece la orientación el escenario girada a la izquierda. |
StageOrientation.UPSIDE_DOWN | Establece la orientación el escenario girada al revés. |
No se establece el parámetro en StageOrientation.UNKNOWN
ni cualquier valor de cadena distinto a los enumerados en la tabla.
Para comprobar si se admite el cambio de orientación del dispositivo, compruebe el valor de la propiedad Stage.supportsOrientantionChange
. Compruebe la lista proporcionada por la propiedad supportedOrientations
para determinar qué orientaciones son compatibles con el dispositivo actual.
Definir la orientación es una operación asíncrona. No se puede garantizar que se complete inmediatamente justo después de llamar al método setOrientation()
. Añada un detector de eventos para que el evento orientationChange
determine cuándo se completa el cambio de orientación.
Importante: el método setOrientation()
no se admite en dispositivos Android previos a AIR 2.6.
setOrientation()
no provoca la distribución de un evento orientationChanging
.
Parámetros
newOrientation:String — La nueva orientación del escenario.
|
Eventos
orientationChange: — El escenario cambia de tamaño como resultado de la llamada al método setOrientation() .
|
Emite
ArgumentError — El valor transferido como parámetro newOrientation no es válido. El valor debe coincidir con una de las constantes definidas en la clase StageOriention, excepto la constante StageOrientation.UNKNOWN .
|
Elementos de API relacionados
swapChildrenAt | () | método |
override public function swapChildrenAt(index1:int, index2:int):void
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Intercambia el orden z (de delante a atrás) de los objetos secundarios situados en las posiciones de índice especificadas en la lista de elementos secundarios. Todos los demás objetos secundarios del contenedor de objeto de visualización permanecerán en la misma posición de índice.
Parámetros
index1:int — Posición de índice del primer objeto secundario.
| |
index2:int — Posición de índice del segundo objeto secundario.
|
Emite
SecurityError — Al llamar al método swapChildrenAt() de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario de alguno de los objetos que se van a intercambiar. Para evitar esto, los propietarios del objeto pueden conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
willTrigger | () | método |
override public function willTrigger(type:String):Boolean
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. Este método devuelve true
si se desencadena un detector de eventos durante cualquier fase del flujo del evento cuando se distribuye un evento del tipo especificado a este objeto EventDispatcher o a cualquiera de sus descendientes.
La diferencia entre los métodos hasEventListener()
y willTrigger()
reside en que hasEventListener()
examina sólo el objeto al que pertenece, mientras que el método willTrigger()
examina todo el flujo del evento especificado por el parámetro type
.
Si se llama a willTrigger()
desde un objeto LoaderInfo, sólo se tendrán en cuenta los detectores a los que puede acceder la función que origina la llamada.
Parámetros
type:String — El tipo de evento.
|
Boolean — Un valor true si se desencadena un detector del tipo especificado; de lo contrario, false .
|
Emite
SecurityError — Al llamar al método willTrigger() de un objeto Stage, se emite una excepción para cualquier origen de llamada que no esté en el mismo entorno limitado de seguridad que el propietario del objeto Stage (el archivo SWF principal). Para evitar esto, el propietario de Stage puede conceder permiso al dominio del origen de llamada llamando al método Security.allowDomain() o Security.allowInsecureDomain() . Para obtener más información, consulte el capítulo “Seguridad” de la Guía del desarrollador de ActionScript 3.0.
|
browserZoomChange | Evento |
flash.events.Event
propiedad Event.type =
flash.events.Event.BROWSER_ZOOM_CHANGE
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 15 |
Se distribuye cuando la propiedad browserZoomFactor
del objeto Stage cambia.
Event.BROWSER_ZOOM_CHANGE
define el valor de la propiedad type
de un objeto de evento browserZoomChange
.
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 | La instancia Stage. |
fullScreen | Evento |
flash.events.FullScreenEvent
propiedad FullScreenEvent.type =
flash.events.FullScreenEvent.FULL_SCREEN
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9.0.28.0, Flash Lite 4 |
Se distribuye cuando el objeto Stage pasa a, o deja de estar en, modo de pantalla completa. El cambio a modo de pantalla completa se puede iniciar a través de ActionScript o cuando el usuario utiliza un método abreviado del teclado, o bien si la selección actual abandona la ventana de pantalla completa.
La constanteFullScreenEvent.FULL_SCREEN
define el valor de la propiedad type
de un objeto de evento fullScreen
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
fullScreen | true si el estado de visualización es la pantalla completa o false si es normal. |
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 | El objeto Stage. |
mouseLeave | Evento |
flash.events.Event
propiedad Event.type =
flash.events.Event.MOUSE_LEAVE
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Lo distribuye el objeto Stage cuando el puntero sale del área del escenario. Si se pulsa el botón del ratón, el evento no se distribuye.
La constanteEvent.MOUSE_LEAVE
define el valor de la propiedad type
de un objeto de evento mouseLeave
.
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 | El objeto Stage. 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. |
orientationChange | Evento |
flash.events.StageOrientationEvent
propiedad StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGE
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.0 |
Distribuido por el objeto Stage cuando cambia la orientación del escenario.
Los cambios de orientación pueden producirse cuando el usuario gira el dispositivo, abre un teclado emergente o cuando se llama a setAspectRatio()
.
Nota: si la propiedad autoOrients
es false
, la orientación del escenario no cambia cuando se gira un dispositivo. Por consiguiente, StageOrientationEvents sólo se distribuye cuando gira el dispositivo si autoOrients
es true
.
ORIENTATION_CHANGE
define el valor de la propiedad type
de un objeto de evento orientationChange
. Este evento tiene las propiedades siguientes:
Propiedades | Valores |
---|---|
afterOrientation | La nueva orientación del escenario. |
beforeOrientation | La orientación antigua del escenario. |
target | El objeto Stage que distribuyó el cambio de orientación. |
bubbles | true |
currentTarget | Indica el objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
cancelable | false ; es demasiado tarde para cancelar el cambio. |
orientationChanging | Evento |
flash.events.StageOrientationEvent
propiedad StageOrientationEvent.type =
flash.events.StageOrientationEvent.ORIENTATION_CHANGING
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 2.0 |
Distribuido por el objeto Stage cuando la orientación del escenario comienza a cambiar.
Importante: los eventos orientationChanging no se distribuyen en dispositivos Android.
Notas:
-
Si la propiedad
autoOrients
esfalse
, la orientación del escenario no cambia cuando se gira un dispositivo. Por consiguiente, StageOrientationEvents sólo se distribuye cuando gira el dispositivo siautoOrients
estrue
. -
Cuando se establece la orientación mediante programación con el método
setOrientation()
, el eventoorientationChanging
no se distribuye.
ORIENTATION_CHANGING
define el valor de la propiedad type
de un objeto de evento orientationChanging
. Este evento tiene las propiedades siguientes:
Propiedades | Valores |
---|---|
afterOrientation | La nueva orientación del escenario. |
beforeOrientation | La orientación antigua del escenario. |
target | El objeto Stage que distribuyó el cambio de orientación. |
bubbles | true |
currentTarget | Indica el objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
cancelable | true . |
resize | Evento |
flash.events.Event
propiedad Event.type =
flash.events.Event.RESIZE
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye cuando la propiedad scaleMode
del objeto Stage se establece en StageScaleMode.NO_SCALE
y se cambia el tamaño del archivo SWF. También se distribuye cuando cambia la orientación de la pantalla mientras está en modo de pantalla completa en Flash Player 15 y versiones posteriores.
Event.RESIZE
define el valor de la propiedad type
de un objeto de evento resize
.
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 | El objeto Stage. |
stageVideoAvailability | Evento |
flash.events.StageVideoAvailabilityEvent
propiedad StageVideoAvailabilityEvent.type =
flash.events.StageVideoAvailabilityEvent.STAGE_VIDEO_AVAILABILITY
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 1.0, Flash Player 10.2 |
Distribuido por el objeto Stage cuando cambia el estado de la propiedad stageVideos.
Define el valor de la propiedadtype
para un objeto de evento stageVideoAvailability
.
Este evento tiene las propiedades siguientes:
Propiedad | Valor |
---|---|
availability | El estado comunicado por el evento. |
bubbles | false |
cancelable | false ; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | El objeto que procesa de forma activa el evento. |
target | El objeto Stage informa sobre la disponibilidad del vídeo en el escenario. |
Ejemplo ( Cómo utilizar este ejemplo )
StageExample
para distribuir eventos cada vez que se activa o cambia el tamaño del escenario. Esto se consigue siguiendo los pasos siguientes:
- El constructor de la clase establece primero la aplicación Flash que se va a fijar, independientemente del tamaño de la ventana de Flash Player y luego añade dos detectores de eventos con los métodos
activateHandler()
yresizeHandler()
. - Se ejecuta el método
activateHandler()
cuando se hace clic en el botón izquierdo del ratón. - Se ejecuta el método
resizeHandler()
cuando cambia el tamaño del escenario.
package { import flash.display.Sprite; import flash.display.StageAlign; import flash.display.StageScaleMode; import flash.events.Event; public class StageExample extends Sprite { public function StageExample() { stage.scaleMode = StageScaleMode.NO_SCALE; stage.align = StageAlign.TOP_LEFT; stage.addEventListener(Event.ACTIVATE, activateHandler); stage.addEventListener(Event.RESIZE, resizeHandler); } private function activateHandler(event:Event):void { trace("activateHandler: " + event); } private function resizeHandler(event:Event):void { trace("resizeHandler: " + event); trace("stageWidth: " + stage.stageWidth + " stageHeight: " + stage.stageHeight); } } }
VsyncStateChangeAvailability | Evento |
flash.events.VsyncStateChangeAvailabilityEvent
propiedad VsyncStateChangeAvailabilityEvent.type =
flash.events.VsyncStateChangeAvailabilityEvent
Versión del lenguaje: | ActionScript 3.0 |
Versiones de motor de ejecución: | AIR 29.0 |
Distribuido por el objeto Stage cuando cambia el estado de la propiedad vsync.
Define el valor de la propiedad type de un objeto de evento VsyncStateChangeAvailabilityEvent
.
Ejemplo ( Cómo utilizar este ejemplo )
VsyncExample
para enviar eventos siempre que el estado de vsync del escenario pueda activarse o desactivarse. Esto se consigue siguiendo los pasos siguientes:
- En primer lugar, el constructor activa el evento
VsyncStateChangeAvailabilityEvent
del escenario. - A continuación, se llama al método
onVsyncStateChangeAvailabilit
, en el que se comprueba siVsyncStateChangeAvailabilityEvent
está disponible o no. - Si está disponible, se puede cambiar el estado de vsync del escenario o, de lo contrario, la propiedad
vsyncEnable
será de solo lectura. - El valor del vsync habilitado se puede activar únicamente si se ha activado el evento.
package { import flash.display.Sprite; import flash.events.VsyncStateChangeAvailabilityEvent public class VsyncExample extends Sprite { public function VsyncExample() { stage.addEventListener(VsyncStateChangeAvailabilityEvent.VSYNC_STATE_CHANGE_AVAILABILITY, onVsyncStateChangeAvailability); } public function onVsyncStateChangeAvailability(event:VsyncStateChangeAvailabilityEvent):void { if (event.available) { // vsyncEnabled is now changeable and can be turned off. stage.vsyncEnabled = false; // Now, AS can change VSYNC state because event.available is true trace("vsyncEnabled of Stage object is changeable"); } else { // vsyncEnabled is not changeable now. This could be due to fallback to software rendering, for example. stage.vsyncEnabled = false; // This will be ignored because event.available is now false trace("vsyncEnabled of Stage object is read-only"); trace("Current value of vsyncEnabled of Stage object is "+ stage.vsyncEnabled); } } } }
Tue Jun 12 2018, 02:12 PM Z