| 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 |
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.
Elementos da API relacionados
flash.events.TouchEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
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é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 | ||
[substituir]
Cria uma cópia do objeto GestureEvent e define o valor de cada propriedade para corresponder ao do original. | GestureEvent | ||
|
Uma função de utilitário para implementar o método toString() em classes ActionScript 3.0 Event personalizadas. | Event | |
|
Indica se um objeto tem uma propriedade especificada definida. | Object | |
|
Verifica se o método preventDefault() foi chamado no evento. | Event | |
|
Indica se uma ocorrência da classe Object está na cadeia de protótipos do objeto especificado como o parâmetro. | Object | |
|
Cancela um comportamento padrão de evento se esse comportamento puder ser cancelado. | Event | |
|
Indica se a propriedade especificada existe e é enumerável. | Object | |
|
Define a disponibilidade de uma propriedade dinâmica para operações de repetição. | Object | |
|
Impede o processamento de qualquer ouvinte de evento no nó atual e qualquer nó subsequente no fluxo de eventos. | Event | |
|
Impede o processamento de algum ouvinte de evento em nós subsequentes ao nó atual no fluxo de eventos. | Event | |
|
Retorna a representação da string deste objeto, formatado segundo as convenções específicas para a localidade. | Object | |
[substituir]
Retorna uma string que contém todas as propriedades do objeto GestureEvent. | GestureEvent | ||
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 | ||
|
Retorna o valor primitivo do objeto especificado. | Object | |
| 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 | ||
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):voidcontrolKey | 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):voidctrlKey | 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):voidlocalX | propriedade |
localY | propriedade |
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):voidElementos da API relacionados
shiftKey | propriedade |
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():NumberstageY | 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():NumberGestureEvent | () | 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âmetrostype:String — O tipo de evento. O valor suportado é: GestureEvent.GESTURE_TWO_FINGER_TAP.
| |
bubbles:Boolean (default = true) | |
cancelable:Boolean (default = false) | |
phase:String (default = null) | |
localX:Number (default = 0) | |
localY:Number (default = 0) | |
ctrlKey:Boolean (default = false) | |
altKey:Boolean (default = false) | |
shiftKey:Boolean (default = false) | |
commandKey:Boolean (default = false) | |
controlKey:Boolean (default = false) |
Elementos da API relacionados
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.
RetornaEvent — 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 ... ]
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.
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
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"
}
Wed Jun 13 2018, 11:10 AM Z