GestureEvent

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

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

A classe GestureEvent permite que você lide com eventos de multitoque em dispositivos que detectam o contato de usuário complexo com o dispositivo (como pressionar dois dedos em uma tela de toque ao mesmo tempo). Quando um usuário interage com um dispositivo, como um telefone móvel ou tablet com uma tela sensível ao toque, o usuário normalmente toca e se move pela tela com os seus dedos ou um dispositivo apontador. Você pode desenvolver aplicativos que respondem a esta interação de usuário com as classes GestureEvent e TransformGestureEvent. Crie ouvintes de evento que usem os tipos de evento definidos aqui, ou nas classes relacionadas TouchEvent relacionado e TransformGestureEvent. E, use as propriedades e os métodos destas classes para construir controladores de eventos que respondem ao usuário que toca o dispositivo.

Use a classe de Multitoque para determinar o suporte do ambiente atual da interação de toque e para gerenciar o suporte da interação de toque se o ambiente atual suportar.

Observação: Quando os objetos estiverem aninhados na lista de exibição, os eventos de toque direcionam o objeto aninhado mais profundo possível que está visível na lista de exibição. Este objeto é chamado de nó-alvo. Para ter um ancestral do nó de destino (um objeto que contém o nó de destino na lista de exibição) que recebe a notificação de um evento de toque, use EventDispatcher.addEventListener() no nó ancestral com o conjunto de parâmetros de tipo ao evento de toque específico que deseja detectar.

Veja os exemplos

Elementos da API relacionados

flash.ui.Multitouch
flash.events.TouchEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
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
		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
		GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false) Cria um Objeto de evento que contém informações sobre eventos de multitoque (como pressionar dois dedos em uma tela de toque ao mesmo tempo).	GestureEvent
		clone():Event [substituir] Cria uma cópia do objeto GestureEvent e define o valor de cada propriedade para corresponder ao do original.	GestureEvent
		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 GestureEvent.	GestureEvent
		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_TWO_FINGER_TAP : String = "gestureTwoFingerTap" [estático] Define o valor da propriedade type de um objeto de evento de gesto GESTURE_TWO_FINGER_TAP.	GestureEvent

Detalhes da propriedade

altKey

propriedade

altKey:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2

Indica se a tecla Alt está ativa (true) ou inativa (false). Com suporte apenas para sistemas operacionais Windows e Linux.

Implementação
public function get altKey():Boolean
public function set altKey(value:Boolean):void

commandKey

propriedade

commandKey:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

AIR 2

Indica se a tecla Command está ativada (só no Mac).

No sistema operacional Mac, o valor da propriedade commandKey é o mesmo valor da propriedade ctrlKey. Esta propriedade é sempre falsa no Windows ou Linux.

Implementação
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void

controlKey

propriedade

controlKey:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2

Indica se a tecla Control está ativada no Mac e se a tecla Ctrl está ativada no Windows ou no Linux.

Implementação
public function get controlKey():Boolean
public function set controlKey(value:Boolean):void

ctrlKey

propriedade

ctrlKey:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2

No Windows ou no Linux, indica se a tecla Ctrl está ativa (true) ou inativa (false). No Macintosh, indica se a tecla Control ou se a tecla Command está ativada.

Implementação
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void

localX

propriedade

localX: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 à entidade gráfica continente.

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

localY

propriedade

localY: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 à entidade gráfica continente.

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

phase

propriedade

phase:String

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

Um valor da classe GesturePhase que indica o progresso do gesto de toque. Para a maior parte dos gestos, o valor é begin, updateou end. Para bater e gestos de torneira de dois dedos, o valor de fase é sempre todos uma vez que o evento é despachado. Use este valor para determinar quando um manipulador de eventos responde a uma interação de usuário complexa, ou responde de maneiras diferentes, dependendo da fase atual de um gesto de multitoque (como expansão, movimento e "ação soltar" conforme um usuário tocar e arrastar um objeto visual através de uma tela).

Implementação
public function get phase():String
public function set phase(value:String):void

Elementos da API relacionados

flash.events.GesturePhase

shiftKey

propriedade

shiftKey:Boolean

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2

Indica se a tecla Shift está ativa (true) ou inativa (false).

Implementação
public function get shiftKey():Boolean
public function set shiftKey(value:Boolean):void

stageX

propriedade

stageX: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 evento ocorreu em coordenadas globais de Palco. Esta propriedade é calculada quando a propriedade localX está definida.

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

stageY

propriedade

stageY: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 evento ocorreu em coordenadas globais de Palco. Esta propriedade é calculada quando a propriedade localY está definida.

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

Detalhes do construtor

()

Construtor

public function GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY: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 de evento que contém informações sobre eventos de multitoque (como pressionar dois dedos em uma tela de toque ao mesmo tempo). Objetos Event são transmitidos como parâmetros para ouvintes de eventos.

Parâmetros

	`type:String` — O tipo de evento. O valor suportado é: `GestureEvent.GESTURE_TWO_FINGER_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`) — Um valor da classe GesturePhase que indica o progresso do gesto de toque (começar, atualizar, concluir ou tudo).

	`localX:Number` (default = `0`) — A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente.

	`localY:Number` (default = `0`) — A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica 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.events.GesturePhase

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 GestureEvent e define o valor de cada propriedade para corresponder ao do original.

Retorna

Event — Um novo objeto GestureEvent 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 GestureEvent. A string está no seguinte formato:

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

Retorna

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

updateAfterEvent

()

método

public function updateAfterEvent():void

Versão da linguagem:

ActionScript 3.0

Versões de runtime:

Flash Player 10.1, AIR 2, Flash Lite 4

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.

Detalhes da constante

GESTURE_TWO_FINGER_TAP

Constante

public static const GESTURE_TWO_FINGER_TAP:String = "gestureTwoFingerTap"

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 type de um objeto de evento de gesto GESTURE_TWO_FINGER_TAP.

O objeto GestureEvent 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`	(AIR somente) `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.
`fase`	A fase atual no fluxo de eventos. Para eventos de torneira de dois dedos, este valor é sempre `todos` correspondente ao valor `GesturePhase. TODOS` uma vez que o evento é despachado.
`isRelatedObjectInaccessible`	`true` se a propriedade relatedObject for definida para `null` por causa de regras de área de segurança.
`localX`	A coordenada horizontal na qual o evento ocorreu com relação à entidade gráfica continente.
`localY`	A coordenada vertical na qual o evento ocorreu com relação à entidade gráfica continente.
`shiftKey`	`true` se a tecla Shift estiver ativa; `false` se estiver inativa.
`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.gestureTwoFingerTap
flash.events.GesturePhase

Exemplos Como usar este exemplo

GestureTwoFingerTap.as

O seguinte exemplo mostra o controle de eventos para o evento GESTURE_TWO_FINGER_TAP. Enquanto o usuário executa um gesto de torneira com dois dedos, o mySprite gira, e o myTextField preenche dados com a fase all, que é a única fase de eventos de torneira de dois dedos. Outros gestos da classe TransformGestureEvent suportam início, atualização e encerramento de fases.

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(GestureEvent.GESTURE_TWO_FINGER_TAP , onTwoFingerTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onTwoFingerTap(evt:GestureEvent):void {

    evt.target.rotation -= 45;
    myTextField.text = evt.phase; //"all"

}

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

GestureEvent - AS3

Pacotesx

Elementos de linguagem

Apêndices

Pacote flash.events

altKey

commandKey

controlKey

ctrlKey

localX

localY

phase

shiftKey

stageX

stageY

GestureEvent

clone

toString

updateAfterEvent

GESTURE_TWO_FINGER_TAP