| Pacchetto | flash.ui |
| Classe | public final class Multitouch |
| Ereditarietà | Multitouch  Object |
| Versione linguaggio: | ActionScript 3.0 |
| Versioni 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
Utilizzate le classi elencate per scrivere codice che gestisca tali eventi di tocco. Utilizzate la classe Multitouch per determinare il supporto dell'ambiente corrente per l'interazione del tocco e per gestire tale interazione se l'ambiente corrente supporta l'input tramite tocco.
Non potete creare un oggetto Multitouch direttamente dal codice ActionScript. Se chiamate new Multitouch, viene generata un'eccezione.
Nota: la funzione Multitouch non è supportata per i file SWF incorporati nel codice HTML eseguito su Mac OS.
Altri esempi
Altre informazioni
Christian Cantrell: Supporto multi-tocco e gesti nella piattaforma Flash
Lee Brimelow: Domande frequenti sul multi-tocco per Flash Player 10.1
Piotr Walczyszyn: Sviluppo multi-tocco in Flex
Elementi API correlati
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.GesturePhase
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Nascondi proprietà pubbliche ereditate
Mostra proprietà pubbliche ereditate| Proprietà | Definito da | ||
|---|---|---|---|
 | constructor : Object
Un riferimento all'oggetto classe o alla funzione di costruzione per una determinata istanza di oggetto. | Object | |
| inputMode : String [statico]
Identifica la modalità multi-tocco per la gestione degli eventi di tocco e gesto. | Multitouch | ||
| mapTouchToMouse : Boolean [statico]
Specifica se il runtime AIR mappa gli eventi di tocco agli eventi del mouse. | Multitouch | ||
| maxTouchPoints : int [statico] [sola lettura]
Il numero massimo di punti di tocco contemporanei supportato dall'ambiente corrente. | Multitouch | ||
| supportedGestures : Vector.<String> [statico] [sola lettura]
Un array Vector (un array tipizzato di valori stringa) di tipi di contatto multi-tocco supportati dall'ambiente corrente. | Multitouch | ||
| supportsGestureEvents : Boolean [statico] [sola lettura]
Indica se l'ambiente corrente supporta l'input tramite gesto, ad esempio la rotazione di due dita su uno schermo sensibile. | Multitouch | ||
| supportsTouchEvents : Boolean [statico] [sola lettura]
Indica se l'ambiente corrente supporta l'input di base tramite tocco, ad esempio un singolo tocco del dito. | Multitouch | ||
inputMode | proprietà |
inputMode:String| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Identifica la modalità multi-tocco per la gestione degli eventi di tocco e gesto. Utilizzate questa proprietà per specificare se gli eventi vengono inviati o meno come eventi di tocco con più punti di contatto ed eventi specifici per diversi gesti (ad esempio rotazione e panoramica) o un solo punto di contatto (come un tocco) oppure nessuno (il contatto viene gestito come un evento del mouse). Per impostare questa proprietà, utilizzate i valori della classe flash.ui.MultitouchInputMode.
Il valore predefinito è gesture.
Implementazione
public static function get inputMode():String public static function set inputMode(value:String):voidElementi API correlati
Esempio ( Come utilizzare questo esempio )
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 | proprietà |
mapTouchToMouse:Boolean| Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | AIR 3 |
Specifica se il runtime AIR mappa gli eventi di tocco agli eventi del mouse.
Se è true (valore predefinito), il runtime AIR invia un evento del mouse in aggiunta a un evento di tocco per gli input tramite tocco. Se è false, il runtime non invia eventi del mouse aggiuntivi. L'impostazione di questa proprietà su false può causare un funzionamento non corretto, sui dispositivi che supportano l'input tramite tocco, del codice, delle librerie e dei framework che dipendono dagli eventi del mouse.
Implementazione
public static function get mapTouchToMouse():Boolean public static function set mapTouchToMouse(value:Boolean):voidElementi API correlati
maxTouchPoints | proprietà |
maxTouchPoints:int [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Il numero massimo di punti di tocco contemporanei supportato dall'ambiente corrente.
Nota: su Android, per i dispositivi che supportano più di due punti di contatto, il valore restituito è 2.
Implementazione
public static function get maxTouchPoints():intElementi API correlati
supportedGestures | proprietà |
supportedGestures:Vector.<String> [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Un array Vector (un array tipizzato di valori stringa) di tipi di contatto multi-tocco supportati dall'ambiente corrente. L'array di stringhe può essere utilizzato come tipi di evento per registrare i listener di eventi. I possibili valori sono costanti delle classi GestureEvent, PressAndTapGestureEvent e TransformGestureEvent (ad esempio GESTURE_PAN).
Se il runtime Flash si trova in un ambiente che non supporta alcun tipo di gesto multi-tocco, il valore è null.
Nota: per Mac OS 10.5.3 e versioni successive, Multitouch.supportedGestures restituisce valori non null (che possono erroneamente indicare che gli eventi gesto sono supportati), anche se l'hardware corrente non supporta l'input tramite gesto.
Utilizzate questa proprietà per verificare se i gesti multi-tocco sono supportati. Utilizzate quindi i gestori di eventi per i gesti multi-tocco disponibili. Per i gesti non supportati nell'ambiente corrente, dovete creare un metodo di gestione degli eventi alternativo.
Implementazione
public static function get supportedGestures():Vector.<String>Altri esempi
Elementi API correlati
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
flash.events.GestureEvent
flash.events.PressAndTapGestureEvent
flash.events.TransformGestureEvent
Esempio ( Come utilizzare questo esempio )
Multitouch.supportedGestures cambia in modo da includere tutti i gesti disponibili nell'ambiente software e hardware corrente per il runtime Flash. Se l'array di vettori Multitouch.supportedGestures non contiene uno dei gesti TransformGestureEvent, per quel gesto non viene aggiunto alcun listener di eventi. L'esempio è stato fornito da 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 | proprietà |
supportsGestureEvents:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Indica se l'ambiente corrente supporta l'input tramite gesto, ad esempio la rotazione di due dita su uno schermo sensibile. Gli eventi gesto sono elencati nelle classi TransformGestureEvent, PressAndTapGestureEvent e GestureEvent.
Nota: per Mac OS 10.5.3 e versioni successive, questo valore è sempre true. Multitouch.supportsGestureEvent restituisce true anche se l'hardware non supporta eventi gesto.
Implementazione
public static function get supportsGestureEvents():BooleanAltri esempi
Elementi API correlati
supportsTouchEvents | proprietà |
supportsTouchEvents:Boolean [sola lettura] | Versione linguaggio: | ActionScript 3.0 |
| Versioni runtime: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Indica se l'ambiente corrente supporta l'input di base tramite tocco, ad esempio un singolo tocco del dito. Gli eventi di tocco sono elencati nella classe TouchEvent.
Implementazione
public static function get supportsTouchEvents():BooleanAltri esempi
Elementi API correlati
Multitouch.supportedGestures restituisce null e l'assegnazione di null al vettore di stringhe causa un errore di runtime). Se gli eventi gesto sono supportati, l'esempio visualizza gli eventi della classe TransformGestureEvent supportata nell'ambiente corrente:
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);
}
}
}
}
}
Tue Jun 12 2018, 02:44 PM Z