| Paquete | flash.display |
| Clase | public class InteractiveObject |
| Herencia | InteractiveObject  DisplayObject EventDispatcher Object |
| Subclases | DisplayObjectContainer, SimpleButton, TextField |
| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
No es posible crear una instancia de la clase InteractiveObject directamente. La llamada al constructor new InteractiveObject() emite una excepción ArgumentError.
La propia clase InteractiveObject no incluye ninguna API para representar el contenido en pantalla. Para crear una subclase personalizada de la clase InteractiveObject, amplíe una de las subclases que sí tengan API para representar el contenido en pantalla, como las clases Sprite, SimpleButton, TextField o MovieClip.
Ocultar propiedades públicas heredadas
Mostrar propiedades públicas heredadas| 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 | |
| alpha : Number
Indica el valor de transparencia alfa del objeto especificado. | DisplayObject | |
| 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 | |
| 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 | |
| constructor : Object
Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada. | Object | |
| contextMenu : NativeMenu
Especifica el menú contextual asociado a este objeto. | InteractiveObject | ||
| 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 | |
| focusRect : Object
Especifica si este objeto muestra un rectángulo de selección. | InteractiveObject | ||
| height : Number
Indica la altura del objeto de visualización, expresada en píxeles. | DisplayObject | |
| 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 | |
| mouseEnabled : Boolean
Especifica si este objeto recibe la entrada del ratón, la entrada del usuario o mensajes. | InteractiveObject | ||
| 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 | |
| needsSoftKeyboard : Boolean
Especifica si un teclado virtual (teclado en pantalla) se debe mostrar cuando esta instancia de InteractiveObject recibe la selección. | InteractiveObject | ||
| opaqueBackground : Object
Especifica si el objeto de visualización es opaco con un determinado color de fondo. | DisplayObject | |
| parent : DisplayObjectContainer [solo lectura]
Indica el objeto DisplayObjectContainer que contiene este objeto de visualización. | DisplayObject | |
| 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 | |
| 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 | |
| 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 | ||
| stage : Stage [solo lectura]
El escenario del objeto de visualización. | DisplayObject | |
| 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 | ||
| 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 | |
| width : Number
Indica la anchura del objeto de visualización, expresada en píxeles. | DisplayObject | |
| 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 | ||
|---|---|---|---|
La llamada al nuevo constructor InteractiveObject() emite una excepción ArgumentError. | InteractiveObject | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra un objeto de detector de eventos con un objeto EventDispatcher, de modo que el detector reciba la notificación de un evento. | EventDispatcher | |
|
Distribuye un evento en el flujo del evento. | EventDispatcher | |
|
Devuelve un rectángulo que define el área del objeto de visualización relativo al sistema de coordenadas del objeto targetCoordinateSpace. | DisplayObject | |
|
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 | |
|
Comprueba si el objeto EventDispatcher tiene detectores registrados para un tipo concreto de evento. | EventDispatcher | |
|
Indica si un objeto tiene definida una propiedad especificada. | Object | |
|
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 | |
|
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 un detector del objeto EventDispatcher. | EventDispatcher | |
Muestra un teclado virtual. | InteractiveObject | ||
|
Establece la disponibilidad de una propiedad dinámica para operaciones de bucle. | Object | |
|
Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional. | Object | |
|
Devuelve la representación de cadena del objeto especificado. | Object | |
|
Devuelve el valor simple del objeto especificado. | Object | |
|
Comprueba si hay registrado un detector de eventos con este objeto EventDispatcher o con cualquiera de sus ascendientes para el tipo de evento concreto. | EventDispatcher | |
| Evento | Resumen | Definido por | ||
|---|---|---|---|---|
| [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 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 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 | |||
| 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 | |||
| 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 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 | |||
| 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 | |||
accessibilityImplementation | propiedad |
accessibilityImplementation:AccessibilityImplementation| Versión del lenguaje: | ActionScript 3.0 |
La implementación actual de accesibilidad (AccessibilityImplementation) para esta instancia de InteractiveObject.
Implementación
public function get accessibilityImplementation():AccessibilityImplementation public function set accessibilityImplementation(value:AccessibilityImplementation):voidElementos de API relacionados
contextMenu | propiedad |
contextMenu:NativeMenu| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica el menú contextual asociado a este objeto.
Para contenido ejecutado en Flash Player, esta propiedad es un objeto ContextMenu. En el motor de ejecución de AIR, la clase ContextMenu es una ampliación de la clase NativeMenu; sin embargo, Flash Player sólo admite la clase ContextMenu, no la clase NativeMenu.
Nota: los objetos TextField siempre incluyen un menú del portapapeles en el menú contextual. El menú del portapapeles contiene los comandos Cortar, Copiar, Pegar, Borrar y Seleccionar todo. No es posible eliminar estos comandos del menú contextual para los objetos TextField. En el caso de objetos TextField, seleccionar estos comandos (o sus equivalentes de teclado) no genera eventos clear, copy, cut, paste o selectAll.
Implementación
public function get contextMenu():NativeMenu public function set contextMenu(value:NativeMenu):voidEjemplo ( Cómo utilizar este ejemplo )
var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
spr.graphics.clear();
spr.graphics.beginFill(0xFF0000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
}
doubleClickEnabled | propiedad |
doubleClickEnabled:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Especifica si este objeto recibe eventos doubleClick. El valor predeterminado es false, lo que significa que, de manera predeterminada, toda instancia de InteractiveObject no recibe eventos doubleClick. Si la propiedad doubleClickEnabled se establece con el valor true, la instancia recibirá eventos doubleClick dentro de sus límites. La propiedad mouseEnabled de la instancia de InteractiveObject debe también estar configurada con el valor true para que el objeto reciba eventos doubleClick.
No se distribuye ningún evento al establecer esta propiedad. Debe utilizar el método addEventListener() para añadir un detector de eventos para el evento doubleClick.
Implementación
public function get doubleClickEnabled():Boolean public function set doubleClickEnabled(value:Boolean):voidElementos de API relacionados
focusRect | propiedad |
focusRect:Object| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Especifica si este objeto muestra un rectángulo de selección. Puede tener uno de estos tres valores: true, false o null. Los valores true y false funcionan como siempre: especifican si aparece o no el rectángulo seleccionado. El valor null indica que este objeto obedece a la propiedad stageFocusRect establecida en el escenario.
Implementación
public function get focusRect():Object public function set focusRect(value:Object):voidmouseEnabled | propiedad |
mouseEnabled: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 este objeto recibe la entrada del ratón, la entrada del usuario o mensajes. El valor predeterminado es true, lo que significa que, de manera predeterminada, toda instancia de InteractiveObject que esté en la lista de visualización recibirá eventos de ratón u otros eventos de entrada del usuario. Si mouseEnabled se establece en false, la instancia no recibirá ningún evento de ratón (o cualquier otra entrada de usuario como eventos de teclado). Los elementos secundarios de esta instancia en la lista de visualización no se verán afectados. Para cambiar el comportamiento mouseEnabled de todos los elementos secundarios de un objeto de la lista de visualización, utilice flash.display.DisplayObjectContainer.mouseChildren.
No se distribuye ningún evento al establecer esta propiedad. Debe utilizar el método addEventListener() para crear funcionalidad interactiva.
Implementación
public function get mouseEnabled():Boolean public function set mouseEnabled(value:Boolean):voidElementos de API relacionados
needsSoftKeyboard | propiedad |
needsSoftKeyboard:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.2, AIR 2.6 |
Especifica si un teclado virtual (teclado en pantalla) se debe mostrar cuando esta instancia de InteractiveObject recibe la selección.
De forma predeterminada, el valor es false y pasar la selección a una instancia de InteractiveObject no hace que se muestre un teclado virtual. Si la propiedad needsSoftKeyboard se establece en true, el motor de ejecución muestra un teclado virtual cuando la instancia InteractiveObject esté lista para aceptar la entrada del usuario. Una instancia de InteractiveObject está lista para aceptar la entrada del usuario después de una llamada mediante programación para establecer la propiedad focus del objeto Stage o la interacción con el usuario, como un "toque". Si el sistema del cliente dispone de un teclado físico o no admite teclados virtuales, el teclado virtual no se muestra.
La instancia de InteractiveObject distribuye eventos softKeyboardActivating, softKeyboardActivate y softKeyboardDeactivate cuando el teclado virtual se muestra y se oculta.
Nota: esta propiedad no se admite en aplicaciones de AIR en iOS.
Implementación
public function get needsSoftKeyboard():Boolean public function set needsSoftKeyboard(value:Boolean):voidElementos de API relacionados
softKeyboard | propiedad |
softKeyboard:String| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 21.0 |
Controla la apariencia del teclado virtual.
Los dispositivos con teclado virtual pueden personalizar los botones del teclado para que coincidan con el tipo de entrada esperado. Por ejemplo, si se esperan entradas numéricas, el dispositivo puede utilizar SoftKeyboardType.NUMBER para mostrar sólo números en el teclado virtual. Los valores válidos se definen como constantes en la clase SoftKeyboardType:
- "default"
- "puntuación"
- "url"
- "number"
- "contact"
- "correo electrónico"
- “phone”
- “decimalpad”
Estos valores sirven de sugerencia para que el dispositivo muestre el mejore teclado para cada operación.
El valor predeterminado es SoftKeyboardType.DEFAULT.
Implementación
public function get softKeyboard():String public function set softKeyboard(value:String):voidEmite
ArgumentError — Si se define en cualquier valor que no sea miembro de SoftKeyboardType
|
Elementos de API relacionados
softKeyboardInputAreaOfInterest | propiedad |
softKeyboardInputAreaOfInterest:Rectangle| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.2, AIR 2.6 |
Define el área que debe permanecer en pantalla cuando se muestra un teclado virtual (no disponible en iOS).
Si la propiedad needsSoftKeyboard de este InteractiveObject es true,el motor de ejecución ajusta la pantalla como sea necesario para mantener el objeto visible mientras el usuario escribe. Por lo general, el motor de ejecución utiliza los límites del objeto obtenidos método DisplayObject.getBounds(). Puede especificar una zona diferente con la propiedad softKeyboardInputAreaOfInterest.
Especifique softKeyboardInputAreaOfInterest en coordenadas del escenario.
Nota: en Android, softKeyboardInputAreaOfInterest no se respeta en orientaciones horizontales.
Nota: softKeyboardInputAreaOfInterest no se admite en iOS.
Implementación
public function get softKeyboardInputAreaOfInterest():Rectangle public function set softKeyboardInputAreaOfInterest(value:Rectangle):voidElementos de API relacionados
tabEnabled | propiedad |
tabEnabled:Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Especifica si este objeto está en el orden de tabulación. Si este objeto está en el orden de tabulación, el valor es true; en caso contrario, el valor es false. De forma predeterminada, el valor es false, salvo en lo siguiente:
- En un objeto SimpleButton, el valor es
true. - En un objeto TextField con
type = "input", el valor estrue. - En un objeto Sprite o MovieClip con
buttonMode = true, el valor estrue.
Implementación
public function get tabEnabled():Boolean public function set tabEnabled(value:Boolean):voidtabIndex | propiedad |
tabIndex:int| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Especifica el orden de tabulación de los objetos de un archivo SWF. La propiedad tabIndex es -1 de manera predeterminada, lo que significa que no se ha establecido el índice de tabulación para el objeto.
Si algún objeto mostrado actualmente en el archivo SWF contiene una propiedad tabIndex, se desactivará el orden de tabulación automático y el orden de tabulación se calculará a partir de las propiedades tabIndex de los objetos del archivo SWF. El orden de tabulación personalizado sólo incluye objetos que tienen propiedades tabIndex.
La propiedad tabIndex puede ser un entero no negativo. Los objetos se ordenan conforme a lo que indiquen las propiedades tabIndex y en orden ascendente. Un objeto que tenga un valor tabIndex de 1 precederá a otro objeto que tenga un valor tabIndex de 2. No utilice el mismo valor de tabIndex para varios objetos.
El orden de tabulación personalizado que define la propiedad tabIndex es flat (plano o no jerárquico). Esto significa que no se tienen en cuenta las relaciones jerárquicas entre los objetos del archivo SWF. Todos los objetos del archivo SWF con propiedades tabIndex tendrán su lugar en el orden de tabulación, que se determinará por el orden de los valores de tabIndex.
Nota: para definir el orden de tabulación de instancias de TLFTextField, asigne el elemento secundario del objeto de visualización de TLFTextField como un objeto InteractiveObject y después establezca la propiedad tabIndex. Por ejemplo:
InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;Para invertir el orden de tabulación en el ajuste predeterminado de tres instancias de un objeto TLFTextField (
tlfInstance1, tlfInstance2 y tlfInstance3), utilice:
InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3; InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2; InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
Implementación
public function get tabIndex():int public function set tabIndex(value:int):voidInteractiveObject | () | Información sobre |
public function InteractiveObject()| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
La llamada al constructor new InteractiveObject() emite una excepción ArgumentError. No obstante, puede llamar a los constructores para las siguientes subclases de InteractiveObject:
new SimpleButton()new TextField()new Loader()new Sprite()new MovieClip()
requestSoftKeyboard | () | método |
public function requestSoftKeyboard():Boolean| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.2, AIR 2.6 |
Muestra un teclado virtual.
Al llamar a este método se selecciona la instancia de InteractiveObject y se muestra el teclado virtual, si es necesario. needsSoftKeyboard también debe ser true. Un teclado no se muestra si hay un teclado físico disponible, o si el sistema del cliente no admite teclado virtual.
Nota: este método no se admite en aplicaciones de AIR en iOS.
Valor devueltoBoolean — Un valor de true significa que la solicitud del teclado virtual ha sido concedida; false significa que el teclado virtual no se ha mostrado.
|
Elementos de API relacionados
clear | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.CLEAR| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5, Flash Lite 4 |
Se distribuye cuando el usuario selecciona 'Borrar' (o 'Eliminar') en el menú contextual. Este evento se distribuye al objeto seleccionado actualmente. Si el objeto seleccionado en ese momento es un objeto TextField, el comportamiento predeterminado es hacer que cualquier texto seleccionado en el campo de texto se elimine.
La constanteEvent.CLEAR define el valor de la propiedad type de un objeto de evento clear.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Cualquier instancia de InteractiveObject con un detector registrado para el evento clear. |
Nota: los objetos TextField no distribuyen eventos clear, copy, cut, paste o selectAll. Los objetos TextField siempre incluyen comandos Cortar, Copiar, Pegar, Borrar y Seleccionar todo en el menú contextual. No es posible eliminar estos comandos del menú contextual para los objetos TextField. En el caso de objetos TextField, seleccionar estos comandos (o sus equivalentes de teclado) no genera eventos clear, copy, cut, paste o selectAll. Sin embargo, otras clases que amplían la clase InteractiveObject, incluidos los componentes creados con Flash Text Engine (FTE), distribuirá estos eventos en respuesta a las acciones del usuario como métodos abreviados de teclado y menús contextuales.
click | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.CLICK| 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 un usuario pulsa y suelta el botón principal del dispositivo de señalización sobre el mismo objeto InteractiveObject. Para que tenga lugar un evento click, éste debe ir después de esta serie de eventos: evento mouseDown y luego mouseUp. El objeto de destino debe ser el mismo para ambos eventos; en caso contrario, no se produce el evento click. Puede producirse cualquier número de eventos de ratón entre los eventos mouseDown o mouseUp; el evento click continuará produciéndose.
type de un objeto de evento click.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | Para eventos de clic, este valor es siempre false. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
contextMenu | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.CONTEXT_MENU| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0 |
Se distribuye cuando un gesto de usuario activa el menú contextual asociado al objeto interactivo la aplicación de AIR.
La constanteMouseEvent.CONTEXT_MENU define el valor de la propiedad type de un objeto de evento contextMenu.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | true si se pulsa el botón derecho del ratón; en caso contrario; false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
clickCount | Cuenta el número de clics del ratón para indicar si el evento forma parte de una secuencia de varios clics. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
Elementos de API relacionados
copy | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.COPY| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
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. Este evento se distribuye al objeto seleccionado actualmente. Si el objeto seleccionado en ese momento es un objeto TextField, el comportamiento predeterminado es hacer que cualquier texto seleccionado en el campo de texto se copie en el portapapeles.
Define el valor de la propiedadtype de un objeto de evento copy.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Cualquier instancia de InteractiveObject con un detector registrado para el evento copy. |
Nota: los objetos TextField no distribuyen eventos clear, copy, cut, paste o selectAll. Los objetos TextField siempre incluyen comandos Cortar, Copiar, Pegar, Borrar y Seleccionar todo en el menú contextual. No es posible eliminar estos comandos del menú contextual para los objetos TextField. En el caso de objetos TextField, seleccionar estos comandos (o sus equivalentes de teclado) no genera eventos clear, copy, cut, paste o selectAll. Sin embargo, otras clases que amplían la clase InteractiveObject, incluidos los componentes creados con Flash Text Engine (FTE), distribuirá estos eventos en respuesta a las acciones del usuario como métodos abreviados de teclado y menús contextuales.
cut | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.CUT| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
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. Este evento se distribuye al objeto seleccionado actualmente. Si el objeto seleccionado en ese momento es un objeto TextField, el comportamiento predeterminado es hacer que cualquier texto seleccionado en el campo de texto se corte para el portapapeles.
Define el valor de la propiedadtype de un objeto de evento cut.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Cualquier instancia de InteractiveObject con un detector registrado para el evento cut. |
Nota: los objetos TextField no distribuyen eventos clear, copy, cut, paste o selectAll. Los objetos TextField siempre incluyen comandos Cortar, Copiar, Pegar, Borrar y Seleccionar todo en el menú contextual. No es posible eliminar estos comandos del menú contextual para los objetos TextField. En el caso de objetos TextField, seleccionar estos comandos (o sus equivalentes de teclado) no genera eventos clear, copy, cut, paste o selectAll. Sin embargo, otras clases que amplían la clase InteractiveObject, incluidos los componentes creados con Flash Text Engine (FTE), distribuirá estos eventos en respuesta a las acciones del usuario como métodos abreviados de teclado y menús contextuales.
doubleClick | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.DOUBLE_CLICK| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
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 establecido como true. Para que tenga lugar un evento doubleClick, debe ir inmediatamente después de la siguiente serie de eventos: mouseDown, mouseUp, click, mouseDown, mouseUp. Todos estos eventos deben compartir el mismo destino que el evento doubleClick. El segundo clic, representado por los segundos eventos mouseDown y mouseUp, debe producirse en un período de tiempo específico tras el evento click. La duración permitida para este período varía en función del sistema operativo y suele ser una opción configurable por el usuario. Si el destino es un campo de texto seleccionable, se selecciona la palabra situada bajo el puntero como comportamiento predeterminado. Si el objeto InteractiveObject de destino no tiene el indicador doubleClickEnabled establecido con el valor true, recibe dos eventos click.
La propiedad doubleClickEnabled se establece de forma predeterminada como false.
El comportamiento de selección de texto con doble clic de un objeto TextField no está relacionado con el evento doubleClick. Utilice TextField.doubleClickEnabled para controlar las selecciones TextField.
type de un objeto de evento doubleClick. La propiedad doubleClickEnabled debe ser true para que un objeto genere el evento doubleClick.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | Para eventos de doble clic, este valor es siempre false. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
Elementos de API relacionados
focusIn | Evento |
flash.events.FocusEventpropiedad FocusEvent.type =
flash.events.FocusEvent.FOCUS_IN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye después de que un objeto de visualización quede seleccionado. Esta situación se produce cuando un usuario resalta el objeto con un dispositivo de señalización o mediante navegación con teclado. El receptor de la selección se conoce como objeto de destino de este evento, mientras que la correspondiente instancia de InteractiveObject que deja de estar seleccionada como consecuencia de este cambio se conoce como el objeto relacionado. En la propiedad relatedObject del objeto receptor se almacena una referencia al objeto relacionado. La propiedad shiftKey no se utiliza. Este evento sigue a la distribución del evento focusOut del objeto anterior.
type de un objeto de evento focusIn.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
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. |
keyCode | 0; se aplica sólo a eventos keyFocusChange. |
relatedObject | La instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. |
shiftKey | false; se aplica sólo a eventos keyFocusChange. |
target | La instancia InteractiveObject que acaba de seleccionarse. 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.
|
direction | Dirección desde la que se asigna la selección. Esta propiedad informa sobre el valor del parámetro direction del método assignFocus() del escenario. Si la selección cambia por otro medio, el valor siempre es FocusDirection.NONE. Se aplica únicamente a eventos focusIn. Para todos los demás eventos de selección, el valor es FocusDirection.NONE. |
focusOut | Evento |
flash.events.FocusEventpropiedad FocusEvent.type =
flash.events.FocusEvent.FOCUS_OUT| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye después de que un objeto de visualización deje de estar seleccionado. Esto sucede cuando un usuario resalta un objeto diferente con un dispositivo de señalización o mediante navegación con teclado. El objeto que deja de estar seleccionado se conoce como objeto de destino de este evento, mientras que la correspondiente instancia de InteractiveObject que pasa a estar seleccionada se conoce como el objeto relacionado. En la propiedad relatedObject del objeto de destino se almacena una referencia al objeto relacionado. La propiedad shiftKey no se utiliza. Este evento precede a la distribución del evento focusIn por parte del objeto relacionado.
type de un objeto de evento focusOut.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
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. |
keyCode | 0; se aplica sólo a eventos keyFocusChange. |
relatedObject | La instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. |
shiftKey | false; se aplica sólo a eventos keyFocusChange. |
target | La instancia InteractiveObject que acaba de perder la selección. 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.
|
gestureDirectionalTap | Evento |
flash.events.TransformGestureEventpropiedad TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_DIRECTIONAL_TAP| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 24, Flash Lite 4 |
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.
En concreto, si el usuario mueve un dedo sobre un objeto InteractiveObject y, a continuación, separa los dedos, la instancia de InteractiveObject puede distribuir un evento touchBegin y uno touchEnd (entre otros), además del evento gestureDirectionalTap, o todos ellos si así lo admite el entorno actual. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento touchBegin, el mismo controlador de eventos se ejecutará en un dispositivo táctil. Sin embargo, si elige gestionar el evento gestureDirectionalTap, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para un evento gestual y otro de táctil. Pero la clase flash.ui.Multitouch decide si se activa el evento táctil o el gestual.
Al gestionar las propiedades del objeto de evento, tenga en cuenta que las propiedades localX y localY se establecen en el punto de contacto principal (para Apple TV está en el centro de la pantalla). Las propiedades offsetX y offsetY coinciden con la dirección del gesto.
Nota: Esta API solo admite un toque direccional de un solo dedo.
Define el valor de la propiedadtype de un objeto de evento táctil GESTURE_PRESS_AND_TAP.
El objeto del evento TransformGestureEvent distribuido tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
phase | La fase actual en el flujo del evento. Para eventos de barrido, este valor es siempre all correspondiente al valor GesturePhase.ALL una vez que el evento se distribuye. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase sprite contenida. Para obtener gestos de toque direccionales, este valor es el centro de la pantalla. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase sprite contenida. Para obtener gestos de toque direccionales, este valor es el centro de la pantalla. |
scaleX | La escala horizontal del objeto de visualización. Para obtener gestos de toque direccionales, este valor es 1 |
scaleY | La escala vertical del objeto de visualización. Para obtener gestos de toque direccionales, este valor es 1 |
rotation | El ángulo de giro actual, expresado en grados, del objeto de visualización a lo largo del eje z. Para obtener gestos de toque direccionales, este valor es 0 |
offsetX | Indica la dirección horizontal: 1 para derecha y -1 para izquierda. |
offsetY | Indica la dirección vertical: 1 para hacia abajo y -1 para hacia arriba. |
velocidad | Indica la velocidad de gestos de desplazamiento en píxeles por segundo (solo AIR). |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia de InteractiveObject en el dispositivo táctil. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
Elementos de API relacionados
gestureLongPress | Evento |
flash.events.TapGestureEventpropiedad TapGestureEvent.type =
flash.events.GestureEvent.GESTURE_LONG_PRESS| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Algunos dispositivos también pueden interpretar este contacto como un evento doubleClick.
En concreto, si un usuario toque con dos dedos un objeto InteractiveObject, la instancia de InteractiveObject puede distribuir un evento doubleClick o un evento gestureTwoFingerTap, o ambos si el entorno actual así lo admite. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento doubleClick, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento gestureTwoFingerTap, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Elementos de API relacionados
gesturePan | Evento |
flash.events.TransformGestureEventpropiedad TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_PAN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Algunos dispositivos también pueden interpretar este contacto como un evento mouseOver y como un evento touchOver.
En concreto, si el usuario mueve un dedo sobre un objeto InteractiveObject, la instancia de InteractiveObject puede distribuir un evento mouseOver y un evento touchOver o un evento gesturePan, o todos ellos si así lo admite el entorno actual. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento mouseOver, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento gesturePan, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil GESTURE_PAN.
El objeto del evento TransformGestureEvent distribuido tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
phase | La fase actual en el flujo del evento; un valor de la clase GesturePhase. |
localX | La coordenada horizontal en la que se produce el evento en relación con el objeto de visualización contenido. |
localY | La coordenada vertical en la que se produce el evento en relación con el objeto de visualización contenido. |
scaleX | La escala horizontal del objeto de visualización desde el evento de gesto anterior. Para obtener gestos de desplazamiento, este valor es 1. |
scaleY | La escala vertical del objeto de visualización desde el evento de gesto anterior. Para obtener gestos de desplazamiento, este valor es 1. |
rotation | El ángulo de giro actual, expresado en grados, del objeto de visualización a lo largo del eje z desde el evento de gesto anterior. Para obtener gestos de desplazamiento, este valor es 0. |
offsetX | La traslación horizontal del objeto de visualización desde su posición en el evento de gesto anterior. |
offsetY | La traslación vertical del objeto de visualización desde su posición en el evento de gesto anterior. |
velocidad | La velocidad del evento gestual en píxeles por segundo (solo AIR). Para obtener gestos de desplazamiento, este valor es 0 |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
Ejemplo ( Cómo utilizar este ejemplo )
GESTURE_PAN. Mientras el usuario realiza un gesto de desplazamiento en el dispositivo táctil, myTextField se llena con la fase actual.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_PAN , onPan);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onPan(evt:TransformGestureEvent):void {
evt.target.localX++;
if (evt.phase==GesturePhase.BEGIN) {
myTextField.text = "Begin";
}
if (evt.phase==GesturePhase.UPDATE) {
myTextField.text = "Update";
}
if (evt.phase==GesturePhase.END) {
myTextField.text = "End";
}
}
Elementos de API relacionados
gestureRotate | Evento |
flash.events.TransformGestureEventpropiedad TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ROTATE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Girar dos dedos es un gesto de giro habitual, pero cada dispositivo y sistema operativo puede tener sus propio requisitos para indicar una acción de giro. Algunos dispositivos también interpretan este contacto como una combinación de varios eventos de ratón.
En concreto, si el usuario mueve un dedo sobre un objeto InteractiveObject, la instancia de InteractiveObject puede distribuir un evento mouseOver y un evento clic (entre otros), además del evento gestureZoom, o todos ellos si así lo admite el entorno actual. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento mouseOver, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento gestureRotate, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Al gestionar las propiedades del objeto de evento, tenga en cuenta que las propiedades localX y localY se establecen en el punto de contacto principal. Las propiedades offsetX y offsetY representan la distancia al punto de contacto donde se completa el gesto de giro.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil GESTURE_ROTATE.
Durante este evento, la propiedad rotation contiene el ángulo de rotación. Los valores de rotación son los siguientes:
- De 0 a 180 grados en sentido horario
- DE - 180 a 0 grados en sentido anti-horario
El objeto del evento TransformGestureEvent distribuido tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
phase | La fase actual en el flujo del evento; un valor de la clase GesturePhase. |
localX | La coordenada horizontal en la que se produce el evento en relación con el objeto de visualización contenido. |
localY | La coordenada vertical en la que se produce el evento en relación con el objeto de visualización contenido. |
scaleX | La escala horizontal del objeto de visualización desde el evento de gesto anterior. |
scaleY | La escala vertical del objeto de visualización desde el evento de gesto anterior. |
rotation | El ángulo de giro actual, expresado en grados, del objeto de visualización a lo largo del eje z desde el evento de gesto anterior. |
offsetX | La traslación horizontal del objeto de visualización desde su posición en el evento de gesto anterior. |
offsetY | La traslación vertical del objeto de visualización desde su posición en el evento de gesto anterior. |
velocidad | La velocidad del evento gestual en píxeles por segundo (solo AIR). Para rotar el gesto, este valor es 0 |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
Ejemplo ( Cómo utilizar este ejemplo )
GESTURE_ROTATE. Mientras el usuario realiza un gesto de giro en el dispositivo táctil, mySprite gira y myTextField se llena con la fase actual.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onRotate(evt:TransformGestureEvent):void {
evt.target.rotation -= 45;
if (evt.phase==GesturePhase.BEGIN) {
myTextField.text = "Begin";
}
if (evt.phase==GesturePhase.UPDATE) {
myTextField.text = "Update";
}
if (evt.phase==GesturePhase.END) {
myTextField.text = "End";
}
}
Elementos de API relacionados
gestureSwipe | Evento |
flash.events.TransformGestureEventpropiedad TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_SWIPE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Mover varios dedos en paralelo es un gesto habitual de barrido, pero cada dispositivo y sistema operativo puede tener sus propios requisitos para barridos. Algunos dispositivos también interpretan este contacto como una combinación de varios eventos de ratón.
En concreto, si el usuario mueve un dedo sobre un objeto InteractiveObject y, a continuación, junta los dedos, la instancia de InteractiveObject puede distribuir un evento rollOver y un evento rollOut (entre otros), además del evento gestureSwipe, o todos ellos si así lo admite el entorno actual. Elija cómo desea controlar la interacción del usuario. Si elige gestionar el evento rollOver, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento gestureSwipe, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Al gestionar las propiedades del objeto de evento, tenga en cuenta que las propiedades localX y localY se establecen en el punto de contacto principal. Las propiedades offsetX y offsetY representan la distancia al punto de contacto donde se completa el gesto de barrido.
Nota: aunque algunos dispositivos con sistema operativo Mac OS pueden interpretar el barrido con cuatro dedos, esta API sólo admite barridos con tres dedos.
Define el valor de la propiedadtype para un objeto de evento táctil GESTURE_SWIPE.
El objeto del evento TransformGestureEvent distribuido tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
phase | La fase actual en el flujo del evento. Para eventos de barrido, este valor es siempre all correspondiente al valor GesturePhase.ALL una vez que el evento se distribuye. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
scaleX | La escala horizontal del objeto de visualización. Para gestos de barrido, este valor es 1 |
scaleY | La escala vertical del objeto de visualización. Para gestos de barrido, este valor es 1 |
rotation | El ángulo de giro actual, expresado en grados, del objeto de visualización a lo largo del eje z. Para gestos de barrido, este valor es 0 |
offsetX | Indica la dirección horizontal: 1 para derecha y -1 para izquierda. |
offsetY | Indica la dirección vertical: 1 para hacia abajo y -1 para hacia arriba. |
velocidad | Indica la velocidad de gestos de desplazamiento en píxeles por segundo (solo AIR). Para el resto, este valor es 0 |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
Ejemplo ( Cómo utilizar este ejemplo )
GESTURE_SWIPE. Mientras el usuario realiza un gesto de barrido en el dispositivo táctil, myTextField se llena con la fase all, que es la única fase para eventos de barrido.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_SWIPE , onSwipe);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onSwipe(evt:TransformGestureEvent):void {
if (evt.offsetX == 1 ) {
myTextField.text = "right";
}
if (evt.offsetY == -1) {
myTextField.text = "up";
}
myTextField.text = evt.phase;
}
Elementos de API relacionados
gestureTap | Evento |
flash.events.TapGestureEventpropiedad TapGestureEvent.type =
flash.events.PressAndTapGestureEvent.GESTURE_TAP| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Algunos dispositivos también interpretan este contacto como una combinación de varios eventos de ratón.
En concreto, si el usuario mueve un dedo sobre un objeto InteractiveObject y, a continuación, vuelve a tocar la pantalla, la instancia de InteractiveObject puede distribuir un evento mouseOver y un evento clic (entre otros), además del evento gestureZoom, o todos ellos si así lo admite el entorno actual. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento mouseOver, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento gesturePressAndTap, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Al gestionar las propiedades del objeto de evento, tenga en cuenta que las propiedades localX y localY se establecen en el punto de contacto principal (la “presión”). Las propiedades offsetX y offsetY son la distancia al punto de contacto secundario (el “toque”).
Elementos de API relacionados
gestureZoom | Evento |
flash.events.TransformGestureEventpropiedad TransformGestureEvent.type =
flash.events.TransformGestureEvent.GESTURE_ZOOM| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Separar dos dedos es un gesto de zoom habitual, pero cada dispositivo y sistema operativo puede tener sus propio requisitos para indicar una acción de zoom. Algunos dispositivos también interpretan este contacto como una combinación de varios eventos de ratón.
En concreto, si el usuario mueve un dedo sobre un objeto InteractiveObject y, a continuación, separar los dedos, la instancia de InteractiveObject puede distribuir un evento mouseOver y un evento clic (entre otros), además del evento gestureZoom, o todos ellos si así lo admite el entorno actual. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento mouseOver, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento gestureZoom, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Al gestionar las propiedades del objeto de evento, tenga en cuenta que las propiedades localX y localY se establecen en el punto de contacto principal. Las propiedades offsetX y offsetY representan la distancia al punto de contacto donde se completa el gesto de zoom.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil GESTURE_ZOOM.
El objeto del evento TransformGestureEvent distribuido tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
phase | La fase actual en el flujo del evento; un valor de la clase GesturePhase. |
localX | La coordenada horizontal en la que se produce el evento en relación con el objeto de visualización contenido. |
localY | La coordenada vertical en la que se produce el evento en relación con el objeto de visualización contenido. |
scaleX | La escala horizontal del objeto de visualización desde el evento de gesto anterior. |
scaleY | La escala vertical del objeto de visualización desde el evento de gesto anterior. |
rotation | El ángulo de giro actual, expresado en grados, del objeto de visualización a lo largo del eje z desde el evento de gesto anterior. |
offsetX | La traslación horizontal del objeto de visualización desde su posición en el evento de gesto anterior. |
offsetY | La traslación vertical del objeto de visualización desde su posición en el evento de gesto anterior. |
velocidad | La velocidad del evento gestual en píxeles por segundo (solo AIR). Para el gesto de zoom, este valor es 0 |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
Ejemplo ( Cómo utilizar este ejemplo )
GESTURE_ZOOM. Mientras el usuario realiza un gesto de zoom en el dispositivo táctil, myTextField se llena con la fase actual.
Multitouch.inputMode = MultitouchInputMode.GESTURE;
var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ZOOM , onZoom);
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);
function onZoom(evt:TransformGestureEvent):void {
evt.target.scaleX++;
if (evt.phase==GesturePhase.BEGIN) {
myTextField.text = "Begin";
}
if (evt.phase==GesturePhase.UPDATE) {
myTextField.text = "Update";
}
if (evt.phase==GesturePhase.END) {
myTextField.text = "End";
}
}
Elementos de API relacionados
imeStartComposition | Evento |
flash.events.IMEEvent| Versiones de motor de ejecución: | Flash Lite 4 |
Este evento se distribuye a cualquier cliente app que admite entrada en línea con un IME
keyDown | Evento |
flash.events.KeyboardEventpropiedad KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_DOWN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye cuando el usuario pulsa una tecla. Las asignaciones entre teclas y caracteres especiales varía en función del dispositivo y el sistema operativo. Este tipo de evento se genera después de que se produzca dicha asignación, pero antes del procesamiento de un editor de método de entrada (IME). Los IME se utilizan para introducir caracteres como, por ejemplo, ideogramas chinos, para cuya producción el teclado QWERTY estándar no está preparado. Este evento tiene lugar antes que el evento keyUp.
En AIR, cancelar este evento impide que se puedan introducir caracteres en un campo de texto.
La constanteKeyboardEvent.KEY_DOWN define el valor de la propiedad type de un objeto de evento keyDown.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | true en AIR, false en Flash Player; en AIR, cancelar este evento impide que se puedan introducir caracteres en un campo de texto. |
charCode | El valor de código de carácter de la tecla presionada o soltada. |
commandKey | true en Mac si la tecla Comando está activa. En caso contrario, false |
controlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac si la tecla Control está activa. En caso contrario, false |
ctrlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | El valor de código de tecla de la tecla presionada o soltada. |
keyLocation | La ubicación de la tecla en el teclado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia InteractiveObject que está seleccionada. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
keyFocusChange | Evento |
flash.events.FocusEventpropiedad FocusEvent.type =
flash.events.FocusEvent.KEY_FOCUS_CHANGE| 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 el usuario intenta cambiar la selección empleando la navegación mediante teclado. El comportamiento predeterminado de este evento consiste en cambiar la selección y distribuir los correspondientes eventos focusIn y focusOut.
Este evento se distribuye al objeto seleccionado actualmente. El objeto relacionado para este evento es la instancia de InteractiveObject que pasa a estar seleccionada si no impide el comportamiento predeterminado. Puede impedir el cambio de selección llamando al método preventDefault() en un detector de eventos que esté debidamente registrado en el objeto de destino. La selección cambia y los eventos focusIn y focusOut se distribuyen de forma predeterminada.
type de un objeto de evento keyFocusChange.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | true; llama al método preventDefault() para cancelar el comportamiento predeterminado. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | El valor de código de la tecla presionada para desencadenar un evento keyFocusChange. |
relatedObject | La instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. |
shiftKey | true si el modificador de la tecla Mayús está activado; de lo contrario, es false. |
target | La instancia InteractiveObject que está seleccionada actualmente. 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.
|
keyUp | Evento |
flash.events.KeyboardEventpropiedad KeyboardEvent.type =
flash.events.KeyboardEvent.KEY_UP| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9, Flash Lite 4 |
Se distribuye cuando el usuario suelta una tecla. Las asignaciones entre teclas y caracteres especiales varía en función del dispositivo y el sistema operativo. Este tipo de evento se genera después de que se produzca dicha asignación, pero antes del procesamiento de un editor de método de entrada (IME). Los IME se utilizan para introducir caracteres como, por ejemplo, ideogramas chinos, para cuya producción el teclado QWERTY estándar no está preparado. Este evento tiene lugar después de un evento keyDown y tiene las siguientes características:
KeyboardEvent.KEY_UP define el valor de la propiedad type de un objeto de evento keyUp.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
charCode | Contiene el valor de código de carácter de la tecla presionada o soltada. |
commandKey | true en Mac si la tecla Comando está activa. En caso contrario, false |
controlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac si la tecla Control está activa. En caso contrario, false |
ctrlKey | true en Windows, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | El valor de código de tecla de la tecla presionada o soltada. |
keyLocation | La ubicación de la tecla en el teclado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
target | La instancia InteractiveObject que está seleccionada. El objeto target no siempre es el objeto de la lista de visualización que registró el detector de eventos. Utilice la propiedad currentTarget para acceder al objeto de la lista de visualización que está procesando el evento actualmente. |
middleClick | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.MIDDLE_CLICK| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Se distribuye cuando un usuario pulsa y suelta el botón central del dispositivo de señalización sobre el mismo objeto InteractiveObject. Para que tenga lugar un evento middleClick, éste debe ir después de esta serie de eventos: middleMouseDown y luego el evento middleMouseUp. El objeto de destino debe ser el mismo para ambos eventos; en caso contrario, no se produce el evento middleClick. Puede producirse cualquier número de eventos de ratón entre los eventos middleMouseDown o middleMouseUp; el evento middleClick continuará produciéndose.
type de un objeto de evento middleClick.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | Para eventos de clic central, esta propiedad siempre es false. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
middleMouseDown | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_DOWN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Se distribuye cuando el usuario pulsa el botón central del dispositivo señalador sobre una instancia de InteractiveObject.
Define el valor de la propiedadtype de un objeto de evento middleMouseDown.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | true si se pulsa el botón central del ratón; en caso contrario; false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
clickCount | Cuenta el número de clics del ratón para indicar si el evento forma parte de una secuencia de varios clics. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
middleMouseUp | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.MIDDLE_MOUSE_UP| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.
Define el valor de la propiedadtype de un objeto de evento middleMouseUp.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | true si se pulsa el botón central del ratón; en caso contrario; false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
clickCount | Cuenta el número de clics del ratón para indicar si el evento forma parte de una secuencia de varios clics. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
mouseDown | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.MOUSE_DOWN| 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 el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject. Si el destino es una instancia de SimpleButton, ésta muestra el objeto de visualización downState como comportamiento predeterminado. Si el destino es un campo de texto seleccionable, el campo de texto comienza la selección como comportamiento predeterminado.
type de un objeto de evento mouseDown.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | true si se pulsa el botón principal del ratón; en caso contrario; false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows y Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
clickCount | Cuenta el número de clics del ratón para indicar si el evento forma parte de una secuencia de varios clics. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
mouseFocusChange | Evento |
flash.events.FocusEventpropiedad FocusEvent.type =
flash.events.FocusEvent.MOUSE_FOCUS_CHANGE| 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 el usuario intenta cambiar la selección empleando un dispositivo de señalización. El comportamiento predeterminado de este evento consiste en cambiar la selección y distribuir los correspondientes eventos focusIn y focusOut.
Este evento se distribuye al objeto seleccionado actualmente. El objeto relacionado para este evento es la instancia de InteractiveObject que pasa a estar seleccionada si no impide el comportamiento predeterminado. Puede impedir el cambio de selección llamando a preventDefault() en un detector de eventos que esté debidamente registrado en el objeto de destino. La propiedad shiftKey no se utiliza. La selección cambia y los eventos focusIn y focusOut se distribuyen de forma predeterminada.
type de un objeto de evento mouseFocusChange.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | true; llama al método preventDefault() para cancelar el comportamiento predeterminado. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
keyCode | 0; se aplica sólo a eventos keyFocusChange. |
relatedObject | La instancia InteractiveObject complementaria que se ve afectada por el cambio de la selección. |
shiftKey | false; se aplica sólo a eventos keyFocusChange. |
target | La instancia InteractiveObject que está seleccionada actualmente. 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.
|
mouseMove | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.MOUSE_MOVE| 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 el usuario mueve el dispositivo de señalización mientras éste se encuentra sobre un InteractiveObject. Si el destino es un campo de texto que el usuario está seleccionando, la selección se actualiza como comportamiento predeterminado.
Define el valor de la propiedadtype de un objeto de evento mouseMove.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | true si se pulsa el botón principal del ratón; en caso contrario; false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
mouseOut | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.MOUSE_OUT| 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 el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject. El destino del evento es el objeto que se encontraba previamente bajo el dispositivo de señalización. relatedObject es el objeto al que se movió el dispositivo de señalización. Si el destino es una instancia de SimpleButton, el botón muestra el objeto de visualización upState como comportamiento predeterminado.
El evento mouseOut se distribuye cada vez que el ratón sale del área de algún objeto secundario del contenedor de objeto de visualización, aunque el ratón ya estuviera sobre otro objeto secundario del contenedor de objeto de visualización. Se trata de un comportamiento distinto a la finalidad del evento rollOut, que consiste en simplificar la codificación de comportamientos rollover para contenedores de objetos de visualización con elementos secundarios. Cuando el ratón sale del área de un objeto de visualización o el área de cualquiera de sus elementos secundarios para ir a un objeto que no es uno de sus elementos secundarios, el objeto de visualización distribuye el eventorollOut. Los eventos rollOut se distribuyen consecutivamente y en sentido ascendente por la cadena principal del objeto, comenzando por el objeto y terminando por el elemento principal de nivel más alto que no sea ni la raíz ni un ascendiente de relatedObject.
type de un objeto de evento mouseOut.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | true si se pulsa el botón principal del ratón; en caso contrario; false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
relatedObject | El objeto de la lista de visualización al que señala ahora el dispositivo de señalización. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
mouseOver | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.MOUSE_OVER| 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 el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject. relatedObject es el objeto que se encontraba previamente bajo el dispositivo de señalización. Si el destino es una instancia de SimpleButton, el objeto muestra el objeto de visualización overState o upState, dependiendo de si el botón del ratón está presionado, como comportamiento predeterminado.
El evento mouseOver se distribuye cada vez que el ratón entra en el área de algún objeto secundario del contenedor de objeto de visualización, aunque el ratón ya estuviera sobre otro objeto secundario del contenedor de objeto de visualización. Se trata de un comportamiento distinto a la finalidad del evento rollOver, que consiste en simplificar la codificación de comportamientos rollout para contenedores de objetos de visualización con elementos secundarios. Cuando el ratón entra en el área de un objeto de visualización o el área de cualquiera de sus elementos secundarios desde un objeto que no es uno de sus elementos secundarios, el objeto de visualización distribuye el evento rollOver. Los eventos rollOver se distribuyen consecutivamente y en sentido descendente por la cadena principal del objeto, comenzando por el elemento principal de nivel más alto que no sea ni la raíz ni un ascendiente de relatedObject y terminando por el objeto.
type de un objeto de evento mouseOver.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | true si se pulsa el botón principal del ratón; en caso contrario; false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
relatedObject | El objeto de la lista de visualización al que señalaba el dispositivo de señalización. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
mouseUp | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.MOUSE_UP| 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 el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject. Si el destino es una instancia de SimpleButton, el objeto muestra el objeto de visualización upState. Si el destino es un campo de texto seleccionable, el campo de texto finaliza la selección como comportamiento predeterminado.
type de un objeto de evento mouseUp.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | true si se pulsa el botón principal del ratón; en caso contrario; false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
clickCount | Cuenta el número de clics del ratón para indicar si el evento forma parte de una secuencia de varios clics. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
mouseWheel | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.MOUSE_WHEEL| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Se distribuye cuando se presiona la rueda del ratón sobre una instancia de InteractiveObject. Si el destino es un campo de texto, el texto se desplaza como comportamiento predeterminado. Sólo disponible en sistemas operativos Microsoft Windows.
Define el valor de la propiedadtype de un objeto de evento mouseWheel.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | true si se pulsa el botón principal del ratón; en caso contrario; false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
delta | El número de líneas equivalente a cada giro de la rueda del ratón. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
nativeDragComplete | Evento |
flash.events.NativeDragEventpropiedad NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_COMPLETE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Distribuido por el objeto InteractiveObject iniciador de arrastre cuando el usuario suelta el botón y finaliza el arrastre.
La propiedad dropAction del evento indica la acción establecida por el objeto de arrastre; un valor "none" (DragActions.NONE) indica que se canceló el arrastre o bien que no se aceptó.
El controlador de eventos nativeDragComplete es un buen lugar para actualizar el estado del objeto de visualización iniciador, por ejemplo, eliminando un elemento de una lista (en una acción de arrastre "move") o modificando sus propiedades visuales.
type de un objeto de evento nativeDragComplete.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
allowedActions | Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar. |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
clipboard | Objeto Clipboard que contiene los datos arrastrados. |
dropAction | Acción elegida por el destino de la acción de soltar (none si no se ha definido ninguna). |
nativeDragDrop | Evento |
flash.events.NativeDragEventpropiedad NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_DROP| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
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().
Accede a los datos colocados mediante la propiedad clipboard del objeto de evento.
El controlador de este evento debería definir la propiedad DragManager.dropAction para informar al objeto iniciador cuando se realice la acción de arrastre. Si no se establece ningún valor, el objeto DragManager selecciona un valor predeterminado de la lista de acciones permitidas.
type de un objeto de evento nativeDragDrop.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
allowedActions | Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar. |
bubbles | true |
cancelable | true; si se cancela este evento, se cancela la operación de arrastrar. |
clipboard | Objeto Clipboard que contiene los datos arrastrados. Se puede leer el contenido del portapapeles incluso si el objeto que distribuye este evento no se encuentra en el mismo dominio de seguridad que el iniciador. |
dropAction | Acción elegida por el destino de la acción de soltar (none si no se ha definido ninguna). |
nativeDragEnter | Evento |
flash.events.NativeDragEventpropiedad NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_ENTER| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Distribuido por un objeto InteractiveObject cuando la acción de arrastre entra en sus límites.
Controle los eventos nativeDragEnter o nativeDragOver para permitir que el objeto de visualización se convierta en el destino de colocación.
Para determinar si el objeto que se distribuye puede aceptar la colocación, verifique la idoneidad de los datos de la propiedad clipboard del objeto de evento y las acciones de arrastre permitidas en la propiedad allowedActions.
type de un objeto de evento nativeDragEnter.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
allowedActions | Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar. |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
clipboard | Objeto Clipboard que contiene los datos arrastrados. Sólo se puede leer el contenido del portapapeles si el objeto que distribuye este evento se encuentra en el mismo dominio de seguridad que el iniciador. |
dropAction | Acción elegida por el destino de la acción de soltar (none si no se ha definido ninguna). |
nativeDragExit | Evento |
flash.events.NativeDragEventpropiedad NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_EXIT| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Distribuido por un objeto InteractiveObject cuando la acción de arrastre se sale de los límites.
NativeDragEvent.NATIVE_DRAG_EXIT define el valor de la propiedadtype de un objeto de evento nativeDragExit.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
allowedActions | Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar. |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
clipboard | Objeto Clipboard que contiene los datos arrastrados. Sólo se puede leer el contenido del portapapeles si el objeto que distribuye este evento se encuentra en el mismo dominio de seguridad que el iniciador. |
dropAction | Acción elegida por el destino de la acción de soltar (none si no se ha definido ninguna). |
nativeDragOver | Evento |
flash.events.NativeDragEventpropiedad NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_OVER| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Distribuido continuamente por un objeto InteractiveObject mientras la operación de arrastre se mantiene dentro de sus límites.
Los eventos nativeDragOver se distribuyen cada vez que se mueve el ratón. En Windows y en Mac, también se distribuyen a intervalos más cortos, incluso si no se mueve el ratón.
Controle los eventos nativeDragOver o nativeDragEnter para permitir que el objeto de visualización se convierta en el destino de colocación.
Para determinar si el objeto que se distribuye puede aceptar la colocación, verifique la idoneidad de los datos de la propiedad clipboard del objeto de evento y las acciones de arrastre permitidas en la propiedad allowedActions.
type de un objeto de evento nativeDragOver.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
allowedActions | Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar. |
bubbles | true |
cancelable | true; si se cancela este evento, se cancela la operación de arrastrar. |
clipboard | Objeto Clipboard que contiene los datos arrastrados. Sólo se puede leer el contenido del portapapeles si el objeto que distribuye este evento se encuentra en el mismo dominio de seguridad que el iniciador. |
dropAction | Acción elegida por el destino de la acción de soltar (none si no se ha definido ninguna). |
nativeDragStart | Evento |
flash.events.NativeDragEventpropiedad NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_START| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Distribuido al comienzo de una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().
NativeDragEvent.NATIVE_DRAG_START define el valor de la propiedadtype de un objeto de evento nativeDragStart.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
allowedActions | Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar. |
bubbles | true |
cancelable | true; si se cancela este evento, se cancela la operación de arrastrar. |
clipboard | Objeto Clipboard que contiene los datos arrastrados. |
dropAction | Acción elegida por el destino de la acción de soltar (none si no se ha definido ninguna). |
nativeDragUpdate | Evento |
flash.events.NativeDragEventpropiedad NativeDragEvent.type =
flash.events.NativeDragEvent.NATIVE_DRAG_UPDATE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Distribuido durante una operación de arrastre por el objeto InteractiveObject especificado como iniciador de arrastre en la llamada a DragManager.doDrag().
Los eventos nativeDragUpdate no se distribuyen en Linux.
type de un objeto de evento nativeDragUpdate.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
allowedActions | Objeto NativeDragOptions que especifica las acciones relacionadas con la operación de arrastrar. |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
clipboard | Objeto Clipboard que contiene los datos arrastrados. |
dropAction | Acción elegida por el destino de la acción de soltar (none si no se ha definido ninguna). |
paste | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.PASTE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
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. Este evento se distribuye al objeto seleccionado actualmente. Si el objeto seleccionado en ese momento es un objeto TextField, el comportamiento predeterminado es hacer que el contenido del portapapeles se pegue en el campo de texto en el punto de inserción activo, reemplazando cualquier texto seleccionado en el campo de texto.
La constanteEvent.PASTE define el valor de la propiedad type de un objeto de evento paste.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | verdadero (falso para tiempo de ejecución de AIR). |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Cualquier instancia de InteractiveObject con un detector registrado para el evento paste. |
Nota: los objetos TextField no distribuyen eventos clear, copy, cut, paste o selectAll. Los objetos TextField siempre incluyen comandos Cortar, Copiar, Pegar, Borrar y Seleccionar todo en el menú contextual. No es posible eliminar estos comandos del menú contextual para los objetos TextField. En el caso de objetos TextField, seleccionar estos comandos (o sus equivalentes de teclado) no genera eventos clear, copy, cut, paste o selectAll. Sin embargo, otras clases que amplían la clase InteractiveObject, incluidos los componentes creados con Flash Text Engine (FTE), distribuirá estos eventos en respuesta a las acciones del usuario como métodos abreviados de teclado y menús contextuales.
proximityBegin | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_BEGIN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye cuando el usuario baja un lápiz stylus activo más allá del umbral de detección de proximidad de la pantalla.
La secuencia habitual de eventos que se producen cuando un usuario baja un lápiz stylus a la pantalla, lo mueve por la pantalla y luego lo aleja:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil PROXIMITY_BEGIN.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
proximityEnd | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_END| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
Se distribuye cuando el usuario levanta un lápiz stylus activo por encima del umbral de detección de proximidad de la pantalla.
Un evento proximityEnd no se distribuye cuando el lápiz stylus toca la pantalla.
La secuencia habitual de eventos que se producen cuando un usuario baja un lápiz stylus a la pantalla, lo mueve por la pantalla y luego lo aleja:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil PROXIMITY_END.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
proximityMove | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_MOVE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
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.
La secuencia habitual de eventos que se producen cuando un usuario baja un lápiz stylus a la pantalla, lo mueve por la pantalla y luego lo aleja:
- proximityBegin
- proximityMove
- touchBegin
- touchMove
- touchEnd
- proximityMove
- proximityEnd
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil PROXIMITY_MOVE.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
proximityOut | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OUT| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
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.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil PROXIMITY_OUT.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
proximityOver | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_OVER| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
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.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil PROXIMITY_OVER.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
proximityRollOut | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OUT| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
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.
El destino del evento es el objeto situado bajo el lápiz stylus o un elemento principal de dicho objeto. relatedObject es el objeto sobre el que se movió el lápiz stylus. Los eventos proximityRollOut se distribuyen consecutivamente y en sentido ascendente por la cadena principal del objeto, comenzando por el objeto y terminando por el elemento principal de nivel más alto que no sea ni la raíz ni un ascendiente de relatedObject.
La finalidad del evento proximityRollOut es simplificar la codificación de comportamientos rollover para contenedores de objetos de visualización con elementos secundarios. Cuando el lápiz stylus abandona el área de un objeto de visualización, incluida el área de cualquiera de sus elementos, secundarios para ir a un objeto que no es uno de sus elementos secundarios, el objeto de visualización distribuye el evento proximityRollOut. Este comportamiento es diferente al del evento proximityOut, que se distribuye cada vez que el ratón sale del área de algún objeto secundario del contenedor de objeto de visualización, aunque el ratón permanezca sobre otro objeto secundario del contenedor de objeto de visualización.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype para un objeto de evento táctil PROXIMITY_ROLL_OUT.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
proximityRollOver | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.PROXIMITY_ROLL_OVER| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3 |
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).
El destino del evento es el objeto situado bajo el lápiz stylus o un elemento principal de dicho objeto. relatedObject es el objeto que se encontraba previamente bajo el lápiz stylus. Los eventos proximityRollOver se distribuyen consecutivamente y en sentido descendente por la cadena principal del objeto, comenzando por el elemento principal de nivel más alto que no sea ni la raíz ni un ascendiente de relatedObject y terminando por el objeto.
La finalidad del evento proximityRollOver es simplificar la codificación de comportamientos rollout para contenedores de objetos de visualización con elementos secundarios. Cuando el lápiz stylus entra en el área superior de un objeto de visualización o el área superior de cualquiera de sus elementos secundarios desde un objeto que no es uno de sus elementos secundarios, el objeto de visualización distribuye el evento proximityRollOver. Este comportamiento es diferente al del evento proximityOver, que se distribuye cada vez que el ratón entra en el área de algún objeto secundario del contenedor de objeto de visualización, aunque el ratón ya estuviera sobre otro objeto secundario del contenedor de objeto de visualización.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype para un objeto de evento táctil PROXIMITY_ROLL_OVER.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
timestamp | (Sólo AIR) La marca de hora del evento en milisegundos con relación al inicio de la aplicación. |
touchIntent | (Sólo AIR) Un valor de la clase TouchEventIntent. |
isTouchPointCanceled | (Sólo AIR) true si el evento táctil se cancela debido a la lógica de rechazo de acciones táctiles del dispositivo. |
Elementos de API relacionados
releaseOutside | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.RELEASE_OUTSIDE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 3.3, Flash Player 11.3 |
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. Si el destino es una instancia de SimpleButton, el objeto muestra el objeto de visualización upState. Si el destino es un campo de texto seleccionable, el campo de texto finaliza la selección como comportamiento predeterminado.
type de un objeto de evento releaseOutside.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | false |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
clickCount | Cuenta el número de clics del ratón para indicar si el evento forma parte de una secuencia de varios clics. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | El objeto InteractiveObject presionado previamente con botón del dispositivo señalador y fuera de la instancia se suelta. 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. |
rightClick | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.RIGHT_CLICK| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Se distribuye cuando un usuario pulsa y suelta el botón derecho del dispositivo de señalización sobre el mismo objeto InteractiveObject. Para que tenga lugar un evento rightClick, éste debe ir después de esta serie de eventos: rightMouseDown y luego el evento rightMouseUp. El objeto de destino debe ser el mismo para ambos eventos; en caso contrario, no se produce el evento rightClick. Puede producirse cualquier número de eventos de ratón entre los eventos rightMouseDown o rightMouseUp; el evento rightClick continuará produciéndose.
type de un objeto de evento rightClick.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | Para eventos de clic derecho, esta propiedad siempre es false. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
rightMouseDown | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_DOWN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Se distribuye cuando el usuario pulsa el botón del dispositivo señalador sobre una instancia de InteractiveObject.
Define el valor de la propiedadtype de un objeto de evento rightMouseDown.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | Para eventos de clic derecho, esta propiedad siempre es false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
clickCount | Cuenta el número de clics del ratón para indicar si el evento forma parte de una secuencia de varios clics. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
rightMouseUp | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.RIGHT_MOUSE_UP| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Lite 4 |
Se distribuye cuando el usuario suelta el botón del dispositivo señalador sobre una instancia de InteractiveObject.
Define el valor de la propiedadtype de un objeto de evento rightMouseUp.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | true |
buttonDown | true si se pulsa el botón derecho del ratón; en caso contrario; false. |
cancelable | false; no es posible cancelar el comportamiento predeterminado. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
clickCount | Cuenta el número de clics del ratón para indicar si el evento forma parte de una secuencia de varios clics. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
rollOut | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.ROLL_OUT| 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 el usuario mueve un dispositivo de señalización hacia el exterior de una instancia de InteractiveObject. El destino del evento es el objeto previamente situado bajo el dispositivo de señalización o un elemento principal de dicho objeto. relatedObject es el objeto al que se movió el dispositivo de señalización. Los eventos rollOut se distribuyen consecutivamente y en sentido ascendente por la cadena principal del objeto, comenzando por el objeto y terminando por el elemento principal de nivel más alto que no sea ni la raíz ni un ascendiente de relatedObject.
La finalidad del evento rollOut es simplificar la codificación de comportamientos rollover para contenedores de objetos de visualización con elementos secundarios. Cuando el ratón abandona el área de un objeto de visualización o el área de cualquiera de sus elementos secundarios para ir a un objeto que no es uno de sus elementos secundarios, el objeto de visualización distribuye el evento rollOut. Este comportamiento es diferente al del evento mouseOut, que se distribuye cada vez que el ratón sale del área de algún objeto secundario del contenedor de objeto de visualización, aunque el ratón permanezca sobre otro objeto secundario del contenedor de objeto de visualización.
type de un objeto de evento rollOut.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | false |
buttonDown | true si se pulsa el botón principal del ratón; en caso contrario; false. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
relatedObject | El objeto de la lista de visualización al que señala ahora el dispositivo de señalización. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
rollOver | Evento |
flash.events.MouseEventpropiedad MouseEvent.type =
flash.events.MouseEvent.ROLL_OVER| 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 el usuario mueve un dispositivo de señalización sobre una instancia de InteractiveObject. El destino del evento es el objeto situado bajo el dispositivo de señalización o un elemento principal de dicho objeto. relatedObject es el objeto que se encontraba previamente bajo el dispositivo de señalización. Los eventos rollOver se distribuyen consecutivamente y en sentido descendente por la cadena principal del objeto, comenzando por el elemento principal de nivel más alto que no sea ni la raíz ni un ascendiente de relatedObject y terminando por el objeto.
La finalidad del evento rollOver es simplificar la codificación de comportamientos rollout para contenedores de objetos de visualización con elementos secundarios. Cuando el ratón entra en el área de un objeto de visualización o el área de cualquiera de sus elementos secundarios desde un objeto que no es uno de sus elementos secundarios, el objeto de visualización distribuye el evento rollOver. Este comportamiento es diferente al del evento mouseOver, que se distribuye cada vez que el ratón entra en el área de algún objeto secundario del contenedor de objeto de visualización, aunque el ratón ya estuviera sobre otro objeto secundario del contenedor de objeto de visualización.
type de un objeto de evento rollOver.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows). |
bubbles | false |
buttonDown | true si se pulsa el botón principal del ratón; en caso contrario; false. |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
relatedObject | El objeto de la lista de visualización al que señalaba el dispositivo de señalización. |
localX | La coordenada horizontal en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
localY | La coordenada vertical en la que se produce el evento relacionado con la clase Sprite contenida, si el bloqueo del ratón está desactivado. |
movementX | El cambio en las coordenadas horizontales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
movementY | El cambio en las coordenadas verticales de la posición del ratón desde el último evento de ratón, si el bloqueo del ratón está activado. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia InteractiveObject en el dispositivo de señalización. 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. |
selectAll | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.SELECT_ALL| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10, AIR 1.5 |
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. Este evento se distribuye al objeto seleccionado actualmente. Si el objeto seleccionado en ese momento es un objeto TextField, el comportamiento predeterminado es hacer que se seleccione todo el contenido del campo de texto.
La constanteEvent.SELECT_ALL define el valor de la propiedad type de un objeto de evento selectAll.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | false |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Cualquier instancia de InteractiveObject con un detector registrado para el evento selectAll. |
Nota: los objetos TextField no distribuyen eventos clear, copy, cut, paste o selectAll. Los objetos TextField siempre incluyen comandos Cortar, Copiar, Pegar, Borrar y Seleccionar todo en el menú contextual. No es posible eliminar estos comandos del menú contextual para los objetos TextField. En el caso de objetos TextField, seleccionar estos comandos (o sus equivalentes de teclado) no genera eventos clear, copy, cut, paste o selectAll. Sin embargo, otras clases que amplían la clase InteractiveObject, incluidos los componentes creados con Flash Text Engine (FTE), distribuirá estos eventos en respuesta a las acciones del usuario como métodos abreviados de teclado y menús contextuales.
softKeyboardActivate | Evento |
flash.events.SoftKeyboardEventpropiedad SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.2, AIR 2.6 |
Se distribuye inmediatamente una vez mostrado el teclado en pantalla.
La constanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATE define el valor de la propiedad type del objeto SoftKeyboardEvent cuando aparece un teclado en pantalla. Para este evento, cancellable = false.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
type | SOFT_KEYBOARD_ACTIVATE |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
relatedObjectVal | Referencia a un objeto de la lista de visualización relacionado con el evento. |
triggerTypeVal | Indica si el evento de teclado lo ha activado una aplicación o el usuario. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
Elementos de API relacionados
softKeyboardActivating | Evento |
flash.events.SoftKeyboardEventpropiedad SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.2, AIR 2.6 |
Se distribuye inmediatamente antes de que se muestre el teclado en pantalla.
La constanteSoftKeyboardEvent.SOFT_KEYBOARD_ACTIVATING define el valor de la propiedad type del objeto SoftKeyboardEvent inmediatamente después de aparecer el teclado en pantalla. Para este evento, cancellable = true.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
type | SOFT_KEYBOARD_ACTIVATING |
bubbles | true |
cancelable | true a no ser que el evento lo distribuya un objeto StageText. En el caso de objetos StageText, el evento no se puede cancelar. |
relatedObjectVal | Referencia a un objeto de la lista de visualización relacionado con el evento. |
triggerTypeVal | Indica si el evento de teclado lo ha activado una aplicación o el usuario. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
Elementos de API relacionados
softKeyboardDeactivate | Evento |
flash.events.SoftKeyboardEventpropiedad SoftKeyboardEvent.type =
flash.events.SoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.2, AIR 2.6 |
Se distribuye inmediatamente una vez oculto el teclado en pantalla.
La constanteSoftKeyboardEvent.SOFT_KEYBOARD_DEACTIVATE define el valor de la propiedad type del objeto SoftKeyboardEvent cuando el teclado en pantalla baja o se oculta. Para este evento, cancellable = false.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
type | SOFT_KEYBOARD_DEACTIVATE |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
relatedObjectVal | Referencia a un objeto de la lista de visualización relacionado con el evento. |
triggerTypeVal | Indica si el evento de teclado lo ha activado una aplicación o el usuario. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
Elementos de API relacionados
tabChildrenChange | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.TAB_CHILDREN_CHANGE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Se distribuye cuando cambia el indicador tabChildren del objeto.
Event.TAB_CHILDREN_CHANGE define el valor de la propiedad type de un objeto de evento tabChildrenChange.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
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 cuyo indicador tabChildren ha cambiado. 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. |
tabEnabledChange | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.TAB_ENABLED_CHANGE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Se distribuye cuando cambia el indicador tabEnabled del objeto.
Event.TAB_ENABLED_CHANGE define el valor de la propiedad type de un objeto de evento tabEnabledChange.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
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 InteractiveObject cuyo indicador tabEnabled ha cambiado. 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. |
tabIndexChange | Evento |
flash.events.Eventpropiedad Event.type =
flash.events.Event.TAB_INDEX_CHANGE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | AIR 1.0, Flash Player 9 |
Se distribuye cuando cambia el valor de la propiedad tabIndex del objeto.
Event.TAB_INDEX_CHANGE define el valor de la propiedad type de un objeto de evento tabIndexChange.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
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 cuyo tabIndex ha cambiado. 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. |
textInput | Evento |
flash.events.TextEventpropiedad TextEvent.type =
flash.events.TextEvent.TEXT_INPUT| 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 un usuario escribe uno o varios caracteres de texto. Existen diferentes métodos de introducción de texto que pueden generar este evento: teclados estándar, editores de método de entrada (IME), sistemas de reconocimiento de voz e, incluso, la acción de pegar texto sin formato o información de estilos.
Define el valor de la propiedadtype de un objeto de evento textInput.
Nota: este evento no se distribuye para las teclas Supr o Retroceso.
Este evento tiene las propiedades siguientes:
| Propiedad | Valor |
|---|---|
bubbles | true |
cancelable | true; llama al método preventDefault() para cancelar el comportamiento predeterminado. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
target | Campo de texto en el que se introducen los caracteres. El destino 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. |
text | Carácter o secuencia de caracteres introducidos por el usuario. |
touchBegin | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.TOUCH_BEGIN| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Algunos dispositivos también pueden interpretar este contacto como un evento mouseDown.
En concreto, si un usuario toca una pantalla táctil con un dedo, la instancia de InteractiveObject puede distribuir un evento mouseDown o un evento touchBegin, o ambos si el entorno actual así lo admite. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento mouseDown, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento touchBegin, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil TOUCH_BEGIN.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Ejemplo ( Cómo utilizar este ejemplo )
TOUCH_BEGIN, TOUCH_MOVE, y TOUCH_END. Mientras el punto de contacto se desplaza a lo largo de la pantalla (onTouchMove), la coordenada x con respecto al escenario se traza en la salida. Para los parámetros Sprite.startTouchDrag de la función onTouchBegin, el valor de touchPointID es el valor asignado al objeto de evento. El parámetro bounds es el rectángulo que define los límites del objeto de visualización principal (bg es un objeto de visualización que contiene MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Elementos de API relacionados
touchEnd | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.TOUCH_END| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Algunos dispositivos también pueden interpretar este contacto como un evento mouseUp.
En concreto, si un usuario levanta un dedo de una pantalla táctil, la instancia de InteractiveObject puede distribuir un evento mouseUp o un evento touchEnd, o ambos si el entorno actual así lo admite. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento mouseUp, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento touchEnd, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil TOUCH_END.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Ejemplo ( Cómo utilizar este ejemplo )
TOUCH_BEGIN, TOUCH_MOVE, y TOUCH_END. Mientras el punto de contacto se desplaza a lo largo de la pantalla (onTouchMove), la coordenada x con respecto al escenario se traza en la salida. Para los parámetros Sprite.startTouchDrag de la función onTouchBegin, el valor de touchPointID es el valor asignado al objeto de evento. El parámetro bounds es el rectángulo que define los límites del objeto de visualización principal (bg es un objeto de visualización que contiene MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Elementos de API relacionados
touchMove | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.TOUCH_MOVE| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Se distribuye cuando el usuario toca el dispositivo y se distribuye constantemente hasta que desaparece el punto de contacto. Tenga en cuenta que este evento no requiere la distribución del movimiento real del punto de contacto.
Algunos dispositivos pueden interpretar este contacto como un evento mouseMove. En concreto, si un usuario mueve un dedo sobre una pantalla táctil, la instancia de InteractiveObject puede distribuir un evento mouseMove o un evento touchMove, o ambos si el entorno actual así lo admite. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento mouseMove, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento touchMove, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil TOUCH_MOVE.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Ejemplo ( Cómo utilizar este ejemplo )
TOUCH_BEGIN, TOUCH_MOVE, y TOUCH_END. Mientras el punto de contacto se desplaza a lo largo de la pantalla (onTouchMove), la coordenada x con respecto al escenario se traza en la salida. Para los parámetros Sprite.startTouchDrag de la función onTouchBegin, el valor de touchPointID es el valor asignado al objeto de evento. El parámetro bounds es el rectángulo que define los límites del objeto de visualización principal (bg es un objeto de visualización que contiene MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT;
MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin);
MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove);
MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd);
function onTouchBegin(eBegin:TouchEvent) {
eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this));
trace("touch begin");
}
function onTouchMove(eMove:TouchEvent) {
trace(eMove.stageX);
}
function onTouchEnd(eEnd:TouchEvent) {
eEnd.target.stopTouchDrag(eEnd.touchPointID);
trace("touch end");
}
Elementos de API relacionados
touchOut | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.TOUCH_OUT| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Algunos dispositivos también pueden interpretar este contacto como un evento mouseOut.
En concreto, si un usuario mueve un dedo sobre una pantalla táctil, la instancia de InteractiveObject puede distribuir un evento mouseOut o un evento touchOut, o ambos si el entorno actual así lo admite. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento mouseOut, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento touchOut, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil TOUCH_OUT.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
touchOver | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.TOUCH_OVER| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Algunos dispositivos también pueden interpretar este contacto como un evento mouseOver.
En concreto, si un usuario mueve un dedo sobre un objeto InteractiveObject, la instancia de InteractiveObject puede distribuir un evento mouseOver o un evento touchOver, o ambos si el entorno actual así lo admite. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento mouseOver, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento touchOver, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil TOUCH_OVER.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
touchRollOut | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OUT| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Algunos dispositivos también pueden interpretar este contacto como un evento rollOut.
En concreto, si un usuario mueve un dedo sobre un objeto InteractiveObject, la instancia de InteractiveObject puede distribuir un evento rollOut o un evento touchRollOut, o ambos si el entorno actual así lo admite. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento rollOut, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento touchRollOut, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype para un objeto de evento táctil TOUCH_ROLL_OUT.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
touchRollOver | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.TOUCH_ROLL_OVER| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Algunos dispositivos también pueden interpretar este contacto como un evento rollOver.
En concreto, si un usuario mueve un dedo sobre un objeto InteractiveObject, la instancia de InteractiveObject puede distribuir un evento rollOver o un evento touchRollOver, o ambos si el entorno actual así lo admite. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento rollOver, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento touchRollOver, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype para un objeto de evento táctil TOUCH_ROLL_OVER.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Elementos de API relacionados
touchTap | Evento |
flash.events.TouchEventpropiedad TouchEvent.type =
flash.events.TouchEvent.TOUCH_TAP| Versión del lenguaje: | ActionScript 3.0 |
| Versiones de motor de ejecución: | Flash Player 10.1, AIR 2, Flash Lite 4 |
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). Algunos dispositivos también pueden interpretar este contacto como un evento click.
En concreto, si un usuario toca con un dedo un objeto InteractiveObject, la instancia de InteractiveObject puede distribuir un evento click o un evento touchTap, o ambos si el entorno actual así lo admite. Elija cómo desea controlar la interacción del usuario. Utilice la clase flash.ui.Multitouch para administrar la gestión de eventos táctiles (active la gestión de eventos de gestos táctiles, la gestión de eventos de puntos de toque simple, o desactive los eventos táctiles para que se distribuyan únicamente los eventos de ratón). Si elige gestionar el evento click, el mismo controlador de eventos se ejecutará en un dispositivo táctil y con un dispositivo compatible con ratón. Sin embargo, si elige gestionar el evento touchTap, puede diseñar su controlador de eventos para que responda a las necesidades específicas de un entorno táctil y ofrecer a los usuarios una experiencia táctil más enriquecida. También puede controlar ambos eventos por separado para proporcionar una respuesta diferente para eventos táctiles y eventos de ratón.
Nota: consulte la clase Multitouch para obtener información sobre la compatibilidad con el entorno.
Define el valor de la propiedadtype de un objeto de evento táctil TOUCH_TAP.
El objeto del evento TouchEvent tiene las siguientes propiedades:
| Propiedad | Valor |
|---|---|
altKey | true si la tecla Alt está activa (Windows o Linux). |
bubbles | true |
cancelable | false; no hay ningún comportamiento predeterminado que cancelar. |
commandKey | true en Mac, si la tecla Comando está activa; false si está inactiva. Siempre es false en Windows. |
controlKey | true si la tecla Control o Ctrl está activa; false si está inactiva. |
ctrlKey | true en Windows o Linux, si la tecla Ctrl está activa. true en Mac, si la tecla Ctrl o Comando está activa. En caso contrario, false. |
currentTarget | Objeto que procesa de forma activa el objeto de evento con un detector de eventos. |
eventPhase | La fase actual en el flujo del evento. |
isRelatedObjectInaccessible | true si la propiedad relatedObject se establece en null por motivos de reglas del entorno limitado de seguridad. |
localX | La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida. |
localY | La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida. |
pressure | Un valor entre 0.0 y 1.0 que indica fuerza de contacto con el dispositivo. Si el dispositivo no admite la detección de presión, el valor es 1.0. |
relatedObject | Referencia a un objeto de la lista de visualización relacionado con el evento. |
shiftKey | true si la tecla Mayús está activa; false si está inactiva. |
sizeX | Anchura de la zona de contacto. |
sizeY | Altura de la zona de contacto. |
stageX | La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario. |
stageY | La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario. |
target | La instancia de InteractiveObject en el dispositivo táctil. 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. |
touchPointID | Un número de identificación exclusivo (como un int) asignado al punto táctil. |
Ejemplo ( Cómo utilizar este ejemplo )
Multitouch.inputMode=MultitouchInputMode.TOUCH_POINT;
var mySprite:Sprite = new Sprite();
var myTextField:TextField = new TextField();
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0,0,40,40);
addChild(mySprite);
mySprite.addEventListener(TouchEvent.TOUCH_TAP, taphandler);
function taphandler(e:TouchEvent): void {
myTextField.text = "I've been tapped";
myTextField.y = 50;
addChild(myTextField);
}
Elementos de API relacionados
InteractiveObjectExample que, a su vez, utiliza la clase ChildSprite para dibujar un rectángulo y manipularlo después según varios eventos de ratón. Esta tarea se consigue siguiendo los pasos siguientes:
- En el constructor
InteractiveObjectExample, se crea un nuevo objeto ChildSprite de tipo Sprite denominadochild, que llama al método constructor ChildSprite para dibujar la forma y añadirle eventos de ratón (como se explica en los pasos siguientes). El objetochildse añade al principio de la lista de visualización en las coordenadas x = 0, y = 0. - En la clase
ChildSprite, declare las propiedadessizeyoverSizeque se utilizarán posteriormente en el métododraw()y los métodos MouseEvent. - Declare propiedades que establezcan el color de fondo en naranja, el color cuando se pasa el ratón por encima en amarillo oscuro y color del ratón pulsado en azul claro.
- En el constructor
ChildSprite, se dibuja un cuadrado naranja mediante los métodos de la clase Graphics y el métododraw(). - El constructor añade cuatro métodos de detector de eventos MouseEvent:
mouseOverHandler: vuelve a dibujar un cuadrado más grande de 60 x 60 píxeles de color amarillo oscuro en las coordenadas originales.mouseOutHandler: devuelve el cuadrado a su tamaño y color originales.mouseDownHandler: vuelve a dibujar un cuadrado más grande de 60 x 60 píxeles de color azul claro en las coordenadas originales.mouseUpHandler: igual quemouseOverHandler.
package {
import flash.display.Sprite;
public class InteractiveObjectExample extends Sprite {
public function InteractiveObjectExample() {
var child:Sprite = new ChildSprite();
addChild(child);
}
}
}
import flash.display.Sprite;
import flash.events.MouseEvent;
class ChildSprite extends Sprite {
private var size:uint = 50;
private var overSize:uint = 60;
private var backgroundColor:uint = 0xFFCC00;
private var overColor:uint = 0xCCFF00;
private var downColor:uint = 0x00CCFF;
public function ChildSprite() {
buttonMode = true;
draw(size, size, backgroundColor);
addEventListener(MouseEvent.MOUSE_OVER, mouseOverHandler);
addEventListener(MouseEvent.MOUSE_OUT, mouseOutHandler);
addEventListener(MouseEvent.MOUSE_DOWN, mouseDownHandler);
addEventListener(MouseEvent.MOUSE_UP, mouseUpHandler);
}
private function draw(w:uint, h:uint, bgColor:uint):void {
graphics.clear();
graphics.beginFill(bgColor);
graphics.drawRect(0, 0, w, h);
graphics.endFill();
}
public function mouseOverHandler(event:MouseEvent):void {
trace("mouseOverHandler");
draw(overSize, overSize, overColor);
}
public function mouseOutHandler(event:MouseEvent):void {
trace("mouseOutHandler");
draw(size, size, backgroundColor);
}
public function mouseDownHandler(event:MouseEvent):void {
trace("mouseDownHandler");
draw(overSize, overSize, downColor);
}
public function mouseUpHandler(event:MouseEvent):void {
trace("mouseUpHandler");
draw(overSize, overSize, overColor);
}
}
Tue Jun 12 2018, 02:12 PM Z