| Pacote | flash.ui |
| Classe | public final class Multitouch |
| Herança | Multitouch  Object |
| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
- flash.events.TouchEvent
- flash.events.GestureEvent
- flash.events.GesturePhase
- flash.events.TransformGestureEvent
- flash.events.PressAndTapGestureEvent
Use as classes listadas para gravar o código que trata eventos de toque. Use a classe Multitouche para determinar o suporte do ambiente atual para a interação de toque e para gerenciar o suporte da interação de toque se o ambiente atual suportar a entrada de toque.
Não é possível criar um objeto Multitouch diretamente do código ActionScript. Se você chamar new TextLine(), uma exceção será lançada.
Observação: O recurso de Multitoque não é suportado para arquivos SWF incorporados no HTML executados no sistema operacional Mac.
Saiba mais
Christian Cantrell: suporte a multitoque e gestos na plataforma Flash
Lee Brimelow: perguntas frequentes sobre multitoque do Flash Player 10.1
Piotr Walczyszyn: desenvolvimento de multitoque em Flex
Elementos da API relacionados
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.GesturePhase
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Ocultar propriedades públicas herdadas
Mostrar propriedades públicas herdadas| Propriedade | Definido por | ||
|---|---|---|---|
 | constructor : Object
Uma referência ao objeto de classe ou à função de construtor de uma determinada ocorrência de objeto. | Object | |
| inputMode : String [estático]
Identifica o modo de multitoque de manipulação de eventos de gesto e toque. | Multitouch | ||
| mapTouchToMouse : Boolean [estático]
Especifica se o tempo de execução do AIR mapeia eventos de toque e eventos de mouse. | Multitouch | ||
| maxTouchPoints : int [estático] [somente leitura]
O número máximo de pontos de toque simultâneos suportado pelo ambiente atual. | Multitouch | ||
| supportedGestures : Vector.<String> [estático] [somente leitura]
Uma matriz de Vector (uma matriz digitada de valores de sequência de caracteres) de tipos de contato multitoque suportados no ambiente atual. | Multitouch | ||
| supportsGestureEvents : Boolean [estático] [somente leitura]
Indica se o ambiente atual suporta a entrada de gesto, tal como rotação de dois dedos em volta de uma tela de toque. | Multitouch | ||
| supportsTouchEvents : Boolean [estático] [somente leitura]
Indica se o ambiente atual suporta a entrada de toque básica, tal como um único toque de dedo. | Multitouch | ||
inputMode | propriedade |
inputMode:String| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Identifica o modo de multitoque de manipulação de eventos de gesto e toque. Use esta propriedade para administrar se os eventos são despachados como eventos de toque com múltiplos pontos do contato e eventos específicos de gestos diferentes (tais como rotação e chave), ou um ponto único do contato (como toque), ou nenhum (o contato é tratado como um evento de mouse). Para definir esta propriedade, use os valores da classe flash.ui.MultitouchInputMode.
O valor padrão é gesture.
Implementação
public static function get inputMode():String public static function set inputMode(value:String):voidElementos da API relacionados
Exemplo ( Como usar este exemplo )
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);
}
mapTouchToMouse | propriedade |
mapTouchToMouse:Boolean| Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | AIR 3 |
Especifica se o tempo de execução do AIR mapeia eventos de toque e eventos de mouse.
Quando true, o padrão, o tempo de execução do AIR despacha um evento de mouse além de um evento de toque para entradas de toque. Quando false, o tempo de execução não despacha um evento de mouse adicional. A configuração desta propriedade parafalse poderá fazer com que códigos existentes, bibliotecas e estruturas que dependem de eventos de mouse funcionem incorretamente em dispositivos que suportam essa entrada de toque.
Implementação
public static function get mapTouchToMouse():Boolean public static function set mapTouchToMouse(value:Boolean):voidElementos da API relacionados
maxTouchPoints | propriedade |
maxTouchPoints:int [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
O número máximo de pontos de toque simultâneos suportado pelo ambiente atual.
Observação: no Android, para os dispositivos compatíveis com mais de dois pontos de contato, o valor de retorno é 2.
Implementação
public static function get maxTouchPoints():intElementos da API relacionados
supportedGestures | propriedade |
supportedGestures:Vector.<String> [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Uma matriz de Vector (uma matriz digitada de valores de sequência de caracteres) de tipos de contato multitoque suportados no ambiente atual. A matriz de sequências de caracteres pode ser usada como sob tipos de evento para registrar ouvintes de evento. Os valores possíveis são constantes das classes GestureEvent, PressAndTapGestureEvent e TransformGestureEvent (como GESTURE_PAN).
Se o tempo de execução de Flash estiver em um ambiente que não suporta nenhum gesto de multitoque, o valor será null.
Observação: Para o sistema operacional Mac 10.5.3 e posteriores, Multitouch.supportedGestures retornará valores não nulos (possivelmente indicando incorretamente que os eventos de gesto são suportados) mesmo se o hardware atual não suportar a entrada de gesto.
Use esta propriedade para testar o suporte de gesto de multitoque. Em seguida, use manipuladores de eventos dos gestos de multitoque disponíveis. Para aqueles gestos que não são suportados pelo ambiente atual, você precisará criar a manipulação de eventos alternativa.
Implementação
public static function get supportedGestures():Vector.<String>Elementos da API relacionados
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
flash.events.GestureEvent
flash.events.PressAndTapGestureEvent
flash.events.TransformGestureEvent
Exemplo ( Como usar este exemplo )
Multitouch.supportedGestures muda para incluir todos os gestos disponíveis no ambiente de software e hardware atual do tempo de execução do Flash. Se a matriz de vetores Multitouch.supportedGestures não tiver um dos gestos de TransformGestureEvent, então nenhum ouvinte do evento será adicionado para aquele gesto. Este exemplo vem de Holly Schinsky .
Multitouch.inputMode = MultitouchInputMode.GESTURE;
for each (var item:String in Multitouch.supportedGestures) {
trace("gesture " + item);
if (item == TransformGestureEvent.GESTURE_PAN)
img.addEventListener(TransformGestureEvent.GESTURE_PAN, onPan);
else if (item == TransformGestureEvent.GESTURE_ROTATE)
img.addEventListener(TransformGestureEvent.GESTURE_ROTATE, onRotate);
else if (item == TransformGestureEvent.GESTURE_SWIPE)
img.addEventListener(TransformGestureEvent.GESTURE_SWIPE, onSwipe);
else if (item == TransformGestureEvent.GESTURE_ZOOM)
img.addEventListener(TransformGestureEvent.GESTURE_ZOOM, onZoom);
}
supportsGestureEvents | propriedade |
supportsGestureEvents:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Indica se o ambiente atual suporta a entrada de gesto, tal como rotação de dois dedos em volta de uma tela de toque. Os eventos de gesto são listados nas classes TransformGestureEvent, PressAndTapGestureEvent e GestureEvent.
Observação: Para o sistema operacional Mac 10.5.3 e posteriores, este valor é sempre true. Multitouch.supportsGestureEvent retorna true mesmo se o hardware não suportar eventos de gesto.
Implementação
public static function get supportsGestureEvents():BooleanElementos da API relacionados
supportsTouchEvents | propriedade |
supportsTouchEvents:Boolean [somente leitura] | Versão da linguagem: | ActionScript 3.0 |
| Versões de runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Indica se o ambiente atual suporta a entrada de toque básica, tal como um único toque de dedo. Os eventos de toque são listados na classe TouchEvent.
Implementação
public static function get supportsTouchEvents():BooleanElementos da API relacionados
Multitouch.supportedGestures regressos null e designação null ao vetor de sequências de caracteres que causam um erro de tempo de execução). Se os eventos de gesto forem suportados, o exemplo exibirá os eventos da classe TransformGestureEvent suportada no ambiente atual:
package {
import flash.ui.Multitouch;
import flash.ui.MultitouchInputMode;
import flash.display.Sprite;
import flash.text.TextField;
public class MultitouchExample extends Sprite {
Multitouch.inputMode = MultitouchInputMode.GESTURE;
public function MultitouchExample() {
if(Multitouch.supportsGestureEvents){
var supportedGesturesVar:Vector.<String> = Multitouch.supportedGestures;
var deviceSupports:TextField = new TextField();
deviceSupports.width = 200;
deviceSupports.height = 200;
deviceSupports.wordWrap = true;
for (var i:int=0; i<supportedGesturesVar.length; ++i) {
deviceSupports.appendText(supportedGesturesVar[i] + ", ");
addChild(deviceSupports);
}
}
}
}
}
Wed Jun 13 2018, 11:10 AM Z