PressAndTapGestureEvent

Pacote	flash.events
Classe	public class PressAndTapGestureEvent
Herança	PressAndTapGestureEvent GestureEvent Event Object

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

A classe PressAndTapGestureEvent deixa que você controle o gesto de pressionar-e-tocar em dispositivos ativados pelo toque. Os objetos que herdam propriedades da classe InteractiveObject capturam o ponto de toque primário (pressionar) e um ponto secundário (tocar) no objeto de evento despachado. O gesto de pressionar-e-tocar é normalmente usado para levantar um menu pop-up sensível ao contexto.

Veja os exemplos

Elementos da API relacionados

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

Propriedades públicas

Ocultar propriedades públicas herdadas

Mostrar propriedades públicas herdadas

	Propriedade		Definido por
		altKey : Boolean Indica se a tecla Alt está ativa (true) ou inativa (false).	GestureEvent
		bubbles : Boolean [somente leitura] Indica se um evento é do tipo bubbling.	Event
		cancelable : Boolean [somente leitura] Indica se o comportamento associado ao evento pode ser impedido.	Event
		commandKey : Boolean Indica se a tecla Command está ativada (só no Mac).	GestureEvent
		constructor : Object Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto.	Object
		controlKey : Boolean Indica se a tecla Control está ativada no Mac e se a tecla Ctrl está ativada no Windows ou no Linux.	GestureEvent
		ctrlKey : Boolean No Windows ou no Linux, indica se a tecla Ctrl está ativa (true) ou inativa (false).	GestureEvent
		currentTarget : Object [somente leitura] O objeto que está processando ativamente o objeto Event com um ouvinte de evento.	Event
		eventPhase : uint [somente leitura] A fase atual no fluxo de eventos.	Event
		localX : Number A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente.	GestureEvent
		localY : Number A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente.	GestureEvent
		phase : String Um valor da classe GesturePhase que indica o progresso do gesto de toque.	GestureEvent
		shiftKey : Boolean Indica se a tecla Shift está ativa (true) ou inativa (false).	GestureEvent
		stageX : Number [somente leitura] A coordenada horizontal na qual o evento ocorreu em coordenadas globais de Palco.	GestureEvent
		stageY : Number [somente leitura] A coordenada vertical na qual o evento ocorreu em coordenadas globais de Palco.	GestureEvent
		tapLocalX : Number A coordenada horizontal na qual o evento ocorreu com relação ao objeto interativo continente.	PressAndTapGestureEvent
		tapLocalY : Number A coordenada vertical na qual o evento ocorreu com relação ao objeto interativo continente.	PressAndTapGestureEvent
		tapStageX : Number [somente leitura] A coordenada horizontal na qual o toque ocorreu nas coordenadas globais do Palco.	PressAndTapGestureEvent
		tapStageY : Number [somente leitura] A coordenada vertical na qual o toque ocorreu em coordenadas globais de Palco.	PressAndTapGestureEvent
		target : Object [somente leitura] O destino de evento.	Event
		type : String [somente leitura] O tipo de evento.	Event

Métodos públicos

Ocultar métodos públicos herdados

Mostrar métodos públicos herdados

	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) Cria um objeto Event que contém informações sobre eventos de multitoque complexos, como um usuário que gera um menu pop-up sensível ao contexto.	PressAndTapGestureEvent
		clone():Event [substituir] Cria uma cópia do objeto PressAndTapGestureEvent e define o valor de cada propriedade para corresponder ao do original.	PressAndTapGestureEvent
		formatToString(className:String, ... arguments):String Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas.	Event
		hasOwnProperty(name:String):Boolean Indica se um objeto tem uma propriedade especificada definida.	Object
		isDefaultPrevented():Boolean Verifica se o método preventDefault() foi chamado no evento.	Event
		isPrototypeOf(theClass:Object):Boolean Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro.	Object
		preventDefault():void Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado.	Event
		propertyIsEnumerable(name:String):Boolean Indica se a propriedade especificada existe e é enumerável.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Define a disponibilidade de uma propriedade dinâmica para operações de repetição.	Object
		stopImmediatePropagation():void Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos.	Event
		stopPropagation():void Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos.	Event
		toLocaleString():String Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade.	Object
		toString():String [substituir] Retorna uma string que contém todas as propriedades do objeto PressAndTapGestureEvent.	PressAndTapGestureEvent
		updateAfterEvent():void Atualizará a exibição do tempo de execução de Flash depois de processar o evento de gesto, se a lista de exibição for modificada pelo manipulador de eventos.	GestureEvent
		valueOf():Object Retorna o valor primitivo do objeto especificado.	Object

Constantes públicas

Ocultar constantes públicas herdadas

Mostrar constantes públicas herdadas

	Constante		Definido por
		GESTURE_PRESS_AND_TAP : String = "gesturePressAndTap" [estático] Define o valor da propriedade de tipo de um objeto de evento de toque de GESTURE_PRESS_AND_TAP.	PressAndTapGestureEvent

Detalhes da propriedade

tapLocalX

propriedade

tapLocalX:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

A coordenada horizontal na qual o evento ocorreu com relação ao objeto interativo continente.

Implementação
public function get tapLocalX():Number
public function set tapLocalX(value:Number):void

tapLocalY

propriedade

tapLocalY:Number

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

A coordenada vertical na qual o evento ocorreu com relação ao objeto interativo continente.

Implementação
public function get tapLocalY():Number
public function set tapLocalY(value:Number):void

tapStageX

propriedade

tapStageX:Number [somente leitura]

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

A coordenada horizontal na qual o toque ocorreu nas coordenadas globais do Palco. Esta propriedade é calculada quando a propriedade tapLocalX é definida.

Implementação
public function get tapStageX():Number

tapStageY

propriedade

tapStageY:Number [somente leitura]

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

A coordenada vertical na qual o toque ocorreu em coordenadas globais de Palco. Esta propriedade é calculada quando a propriedade tapLocalX é definida.

Implementação
public function get tapStageY():Number

Detalhes do construtor

()

Construtor

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)

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

Cria um objeto Event que contém informações sobre eventos de multitoque complexos, como um usuário que gera um menu pop-up sensível ao contexto. Objetos Event são transmitidos como parâmetros para ouvintes de eventos.

Parâmetros

	`type:String` — O tipo do evento: `PressAndTapGestureEvent.GESTURE_PRESS_AND_TAP`.

	`bubbles:Boolean` (default = `true`) — Determina se o objeto Evento participa da fase bubbling do fluxo de eventos.

	`cancelable:Boolean` (default = `false`) — Determina se o objeto Event pode ser cancelado.

	`phase:String` (default = `null`) — Estes valores rastreiam o começo, o progresso e o fim de um gesto de toque. Os valores possíveis são: `GesturePhase.BEGIN`, `GesturePhase.END`, `GesturePhase.UPDATE` ou `GesturePhase.ALL`.

	`localX:Number` (default = `0`) — A coordenada horizontal na qual o evento ocorreu com relação ao objeto de exibição continente.

	`localY:Number` (default = `0`) — A coordenada vertical na qual o evento ocorreu com relação ao objeto de exibição continente.

	`tapLocalX:Number` (default = `0`) — A coordenada horizontal na qual o evento ocorreu com relação ao objeto interativo continente.

	`tapLocalY:Number` (default = `0`) — A coordenada vertical na qual o evento ocorreu com relação ao objeto interativo continente.

	`ctrlKey:Boolean` (default = `false`) — No Windows ou no Linux, indica se a tecla Ctrl está ativada. No Mac, indica se a tecla Ctrl ou se a tecla Command está ativada.

	`altKey:Boolean` (default = `false`) — Indica se a tecla Alt está ativada (só no Windows ou no Linux).

	`shiftKey:Boolean` (default = `false`) — Indica se a tecla Shift está ativada.

	`commandKey:Boolean` (default = `false`) — (Somente AIR) Indica se a tecla Command está ativada (só no Mac). Este parâmetro é apenas para o Adobe AIR; não o defina para o conteúdo do Flash Player.

	`controlKey:Boolean` (default = `false`) — (Somente AIR) Indica se a tecla Control ou Ctrl está ativada. Este parâmetro é apenas para o Adobe AIR; não o defina para o conteúdo do Flash Player.

Elementos da API relacionados

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

Detalhes do método

clone

()

método

override public function clone():Event

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

Cria uma cópia do objeto PressAndTapGestureEvent e define o valor de cada propriedade para corresponder ao do original.

Retorna

Event — Um novo objeto PressAndTapGestureEvent com valores de propriedade que correspondem aos do original.

toString

()

método

override public function toString():String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

Retorna uma string que contém todas as propriedades do objeto PressAndTapGestureEvent. A string está no seguinte formato:

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

Retorna

String — Uma string que contém todas as propriedades do objeto PressAndTapGestureEvent.

Detalhes da constante

GESTURE_PRESS_AND_TAP

Constante

public static const GESTURE_PRESS_AND_TAP:String = "gesturePressAndTap"

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

Define o valor da propriedade tipo de um objeto de evento de toque GESTURE_PRESS_AND_TAP.

O objeto PressAndTapGestureEvent despachado tem as seguintes propriedades:

Propriedade	Valor
`altKey`	`true` caso a tecla Alt esteja ativa (Windows ou Linux).
`bubbles`	`true`
`cancelable`	`false`; não há comportamento padrão a ser cancelado.
`commandKey`	`true` no Mac se a tecla Command estiver ativa; `false` se estiver inativa. Sempre `false` no Windows.
`controlKey`	`true` se a tecla Ctrl ou Control estiver ativa; `false` se estiver inativa.
`ctrlKey`	`true` no Windows ou no Linux caso a tecla Ctrl esteja ativa. `true` no Mac se a tecla Ctrl ou Command estiver ativa. Caso contrário, `false`.
`currentTarget`	O objeto que está processando ativamente o objeto Event com um ouvinte de evento.
`eventPhase`	A fase atual enquanto o evento passa pela hierarquia de objetos; um valor numérico que indica que o evento é capturado (1), no destino (2) ou fazendo bolhas (3).
`localX`	A coordenada horizontal na qual o evento ocorreu com relação ao objeto de exibição continente.
`localY`	A coordenada vertical na qual o evento ocorreu com relação ao objeto de exibição continente.
`fase`	A fase atual no fluxo de eventos, um valor da classe GesturePhase class. Os valores possíveis são: `GesturePhase.BEGIN`, `GesturePhase.UPDATE`, `GesturePhase.END` ou `GesturePhase.ALL`. Um gesto de ação de pressionar e tocar gera uma sequência`GesturePhase.BEGIN`, `GesturePhase.UPDATE`, `GesturePhase.END` ou uma única fase `GesturePhase.ALL`.
`shiftKey`	`true` se a tecla Shift estiver ativa; `false` se estiver inativa.
`stageX`	A coordenada horizontal na qual o evento ocorreu em coordenadas globais de palco.
`stageY`	A coordenada vertical na qual o evento ocorreu em coordenadas globais de palco.
`tapLocalX`	A coordenada horizontal na qual o evento ocorreu com relação ao objeto interativo continente.
`tapLocalY`	A coordenada vertical na qual o evento ocorreu com relação ao objeto interativo continente.
`tapStageX`	A coordenada horizontal na qual o toque ocorreu nas coordenadas globais do Palco.
`tapStageY`	A coordenada vertical na qual o toque ocorreu em coordenadas globais de Palco.
`target`	A ocorrência InteractiveObject sob o dispositivo de toque. `target` não é sempre o objeto na lista de exibição que registrou o ouvinte de evento. Use a propriedade `currentTarget` para acessar o objeto na lista de exibição que está processando o evento no momento.

Elementos da API relacionados

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

Exemplos Como usar este exemplo

GesturePressAndTap.as

O seguinte exemplo mostra o controle de eventos para o evento GESTURE_PRESS_AND_TAP. Enquanto o usuário executa um gesto de pressionar-e-tocar, o mySprite gira e myTextField preenche com a fase atual.

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";
    }
}

Aspectos jurídicos | Política de privacidade on-line

PressAndTapGestureEvent - AS3

Classes x

tapLocalX

tapLocalY

tapStageX

tapStageY