PressAndTapGestureEvent

Paquete	flash.events
Clase	public class PressAndTapGestureEvent
Herencia	PressAndTapGestureEvent GestureEvent Event Object

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10.1, AIR 2, Flash Lite 4

La clase PressAndTapGestureEvent permite gestionar gestos de pulsar y tocar en dispositivos táctiles. Los objetos que heredan propiedades de la clase InteractiveObject capturan el punto táctil principal (pulsación) y un punto secundario (toque) en el objeto de evento distribuido. El gesto de pulsar y tocar suele utilizarse para mostrar un menú contextual emergente.

Ver los ejemplos

Elementos de API relacionados

flash.ui.Multitouch
flash.display.InteractiveObject
flash.events.TouchEvent
flash.events.GestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()

Propiedades públicas

Ocultar propiedades públicas heredadas

Mostrar propiedades públicas heredadas

	Propiedad		Definido por
		altKey : Boolean Indica si la tecla Alt está activa (true) o inactiva (false).	GestureEvent
		bubbles : Boolean [solo lectura] Indica si un evento es un evento de propagación.	Event
		cancelable : Boolean [solo lectura] Indica si se puede evitar el comportamiento asociado al evento.	Event
		commandKey : Boolean Indica si la tecla Comando está activada (sólo en Mac).	GestureEvent
		constructor : Object Una referencia a la clase de objeto o función constructora para una instancia de objeto determinada.	Object
		controlKey : Boolean Indica si la tecla Control está activada en Mac y si la tecla Ctrl está activada en Windows o Linux.	GestureEvent
		ctrlKey : Boolean En Windows o Linux, indica si la tecla Ctrl está activa (true) o inactiva (false).	GestureEvent
		currentTarget : Object [solo lectura] Objeto que procesa de forma activa el objeto de evento con un detector de eventos.	Event
		eventPhase : uint [solo lectura] La fase actual en el flujo del evento.	Event
		localX : Number La coordenada horizontal en la que se produce el evento en relación con la clase Sprite contenida.	GestureEvent
		localY : Number La coordenada vertical en la que se produce el evento en relación con la clase Sprite contenida.	GestureEvent
		phase : String Un valor de la clase GesturePhase que indica el progreso del gesto táctil.	GestureEvent
		shiftKey : Boolean Indica si la tecla Mayús está activa (true) o inactiva (false).	GestureEvent
		stageX : Number [solo lectura] La coordenada horizontal en la que se produce el evento en las coordenadas globales del escenario.	GestureEvent
		stageY : Number [solo lectura] La coordenada vertical en la que se produce el evento en las coordenadas globales del escenario.	GestureEvent
		tapLocalX : Number La coordenada horizontal en la que se produce el evento en relación con el objeto interactivo contenido.	PressAndTapGestureEvent
		tapLocalY : Number La coordenada vertical en la que se produce el evento en relación con el objeto interactivo contenido.	PressAndTapGestureEvent
		tapStageX : Number [solo lectura] La coordenada horizontal en la que se produce el evento táctil en las coordenadas globales del escenario.	PressAndTapGestureEvent
		tapStageY : Number [solo lectura] La coordenada vertical en la que se produce el evento táctil en las coordenadas globales del escenario.	PressAndTapGestureEvent
		target : Object [solo lectura] El destino del evento.	Event
		type : String [solo lectura] El tipo de evento.	Event

Métodos públicos

Ocultar métodos públicos heredados

Mostrar métodos públicos heredados

	Método		Definido por
		PressAndTapGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, tapLocalX:Number = 0, tapLocalY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false) Crea un objeto de evento que contiene información sobre complejos eventos multitáctiles, como la aparición de un menú contextual emergente.	PressAndTapGestureEvent
		clone():Event [override] Crea una copia del objeto PressAndTapGestureEvent y define el valor de cada propiedad para que coincida con el del objeto original.	PressAndTapGestureEvent
		formatToString(className:String, ... arguments):String Una función de utilidad para implementar el método toString() en las clases Event personalizadas de ActionScript 3.0.	Event
		hasOwnProperty(name:String):Boolean Indica si un objeto tiene definida una propiedad especificada.	Object
		isDefaultPrevented():Boolean Comprueba si se ha llamado a preventDefault() en el evento.	Event
		isPrototypeOf(theClass:Object):Boolean Indica si hay una instancia de la clase Object en la cadena de prototipo del objeto especificado como parámetro.	Object
		preventDefault():void Cancela el comportamiento predeterminado de un evento si es posible cancelarlo.	Event
		propertyIsEnumerable(name:String):Boolean Indica si existe la propiedad especificada y si es enumerable.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Establece la disponibilidad de una propiedad dinámica para operaciones de bucle.	Object
		stopImmediatePropagation():void Impide el proceso de cualquier detector de eventos en el nodo actual y los nodos siguientes en el flujo del evento.	Event
		stopPropagation():void Impide el proceso de cualquier detector de eventos en nodos siguientes al nodo actual.	Event
		toLocaleString():String Devuelve la representación de cadena de este objeto, con formato según las convenciones específicas de configuración regional.	Object
		toString():String [override] Devuelve una cadena con todas las propiedades del objeto PressAndTapGestureEvent.	PressAndTapGestureEvent
		updateAfterEvent():void Actualiza la visualización del motor de ejecución de Flash después de procesar el evento de gesto, en caso de que se el controlador de eventos haya modificado la lista de visualización.	GestureEvent
		valueOf():Object Devuelve el valor simple del objeto especificado.	Object

Constantes públicas

Ocultar constantes públicas heredadas

Mostrar constantes públicas heredadas

	Constante		Definido por
		GESTURE_PRESS_AND_TAP : String = "gesturePressAndTap" [estática] Define el valor de la propiedad type para un objeto de evento táctil GESTURE_PRESS_AND_TAP.	PressAndTapGestureEvent

Información sobre propiedades

tapLocalX

propiedad

tapLocalX:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10.1, AIR 2, Flash Lite 4

La coordenada horizontal en la que se produce el evento en relación con el objeto interactivo contenido.

Implementación
public function get tapLocalX():Number
public function set tapLocalX(value:Number):void

tapLocalY

propiedad

tapLocalY:Number

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10.1, AIR 2, Flash Lite 4

La coordenada vertical en la que se produce el evento en relación con el objeto interactivo contenido.

Implementación
public function get tapLocalY():Number
public function set tapLocalY(value:Number):void

tapStageX

propiedad

tapStageX:Number [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10.1, AIR 2, Flash Lite 4

La coordenada horizontal en la que se produce el evento táctil en las coordenadas globales del escenario. Esta propiedad se calcula al establecer tapLocalX.

Implementación
public function get tapStageX():Number

tapStageY

propiedad

tapStageY:Number [solo lectura]

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10.1, AIR 2, Flash Lite 4

La coordenada vertical en la que se produce el evento táctil en las coordenadas globales del escenario. Esta propiedad se calcula al establecer tapLocalX.

Implementación
public function get tapStageY():Number

Información sobre constructores

()

Información sobre

public function PressAndTapGestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, tapLocalX:Number = 0, tapLocalY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false)

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10.1, AIR 2, Flash Lite 4

Crea un objeto de evento que contiene información sobre complejos eventos multitáctiles, como la aparición de un menú contextual emergente. Los objetos de evento se transfieren como parámetros a los detectores de eventos.

Parámetros

	`type:String` — El tipo del evento: `PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP`.

	`bubbles:Boolean` (default = `true`) — Determina si el objeto de evento participa en la fase de propagación del flujo del evento.

	`cancelable:Boolean` (default = `false`) — Determina si se puede cancelar el objeto Event.

	`phase:String` (default = `null`) — Este valores siguen el principio, el progreso y el final final del gesto tátcil. Los valores posible son: `GesturePhase.BEGIN`, `GesturePhase.END`, `GesturePhase.UPDATE` o `GesturePhase.ALL`.

	`localX:Number` (default = `0`) — La coordenada horizontal en la que se produce el evento en relación con el objeto de visualización contenido.

	`localY:Number` (default = `0`) — La coordenada vertical en la que se produce el evento en relación con el objeto de visualización contenido.

	`tapLocalX:Number` (default = `0`) — La coordenada horizontal en la que se produce el evento en relación con el objeto interactivo contenido.

	`tapLocalY:Number` (default = `0`) — La coordenada vertical en la que se produce el evento en relación con el objeto interactivo contenido.

	`ctrlKey:Boolean` (default = `false`) — En Windows o en Linux, indica si la tecla Ctrl está activada. En Mac, indica si está activada la tecla Ctrl o Comando.

	`altKey:Boolean` (default = `false`) — Indica si la tecla Alt está activada (sólo Windows o Linux).

	`shiftKey:Boolean` (default = `false`) — Indica si la tecla Mayús está activada.

	`commandKey:Boolean` (default = `false`) — (Sólo AIR) Indica si la tecla Comando está activada (sólo en Mac). Este parámetro es solamente para Adobe AIR; no lo establezca en el contenido de Flash Player.

	`controlKey:Boolean` (default = `false`) — (Sólo AIR) Indica si la tecla Control o Ctrl está activada. Este parámetro es solamente para Adobe AIR; no lo establezca en el contenido de Flash Player.

Elementos de API relacionados

flash.ui.Multitouch
flash.events.TouchEvent
flash.events.GestureEvent
flash.events.GesturePhase
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()

Información sobre métodos

clone

()

método

override public function clone():Event

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10.1, AIR 2, Flash Lite 4

Crea una copia del objeto PressAndTapGestureEvent y define el valor de cada propiedad para que coincida con el del objeto original.

Valor devuelto

Event — Un nuevo objeto PressAndTapGestureEvent con valores de propiedades que coinciden con los del objeto original.

toString

()

método

override public function toString():String

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10.1, AIR 2, Flash Lite 4

Devuelve una cadena con todas las propiedades del objeto PressAndTapGestureEvent. La cadena tiene el siguiente formato:

[PressAndTapGestureEvent type=valor bubbles=valor cancelable=valor ... ]

Valor devuelto

String — Una cadena que contiene todas las propiedades del objeto PressAndTapGestureEvent.

Información sobre constantes

GESTURE_PRESS_AND_TAP

Constante

public static const GESTURE_PRESS_AND_TAP:String = "gesturePressAndTap"

Versión del lenguaje:

ActionScript 3.0

Versiones de motor de ejecución:

Flash Player 10.1, AIR 2, Flash Lite 4

Define el valor de la propiedad type para un objeto de evento táctil GESTURE_PRESS_AND_TAP.

El objeto del evento PressAndTapGestureEvent 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 a medida que el evento pasa a través de la jerarquía del objeto; un valor numérico que indica si el evento se captura (1), el destino (2) o si se propaga (3).
`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.
`phase`	La fase actual del flujo de evento; un valor de la clase GesturePhase class. Los valores posibles son: `GesturePhase.BEGIN`, `GesturePhase.UPDATE`, `GesturePhase.END` o `GesturePhase.ALL`. Un gesto de pulsar y tocar genera una secuencia `GesturePhase.BEGIN`, `GesturePhase.UPDATE`, `GesturePhase.END` o el gesto genera una única fase `GesturePhase.ALL`.
`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.
`tapLocalX`	La coordenada horizontal en la que se produce el evento en relación con el objeto interactivo contenido.
`tapLocalY`	La coordenada vertical en la que se produce el evento en relación con el objeto interactivo contenido.
`tapStageX`	La coordenada horizontal en la que se produce el evento táctil en las coordenadas globales del escenario.
`tapStageY`	La coordenada vertical en la que se produce el evento táctil 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.

Elementos de API relacionados

flash.display.InteractiveObject.gesturePressAndTap
flash.events.GesturePhase

Ejemplos Cómo utilizar este ejemplo

GesturePressAndTap.as

En el ejemplo siguiente, se muestra gestión de eventos para el evento GESTURE_PRESS_AND_TAP. Mientras el usuario realiza un gesto de pulsar y tocar, mySprite gira y myTextField se llena con la fase actual.

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP , onPressAndTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onPressAndTap(evt:PressAndTapGestureEvent):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";
    }
}

Avisos legales | Política de privacidad en línea

PressAndTapGestureEvent - AS3

Clases x

tapLocalX

tapLocalY

tapStageX

tapStageY