Multitouch - Guida di riferimento alle API Adobe ActionScript® 3 (AS3 )

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

La classe Multitouch gestisce e fornisce informazioni sul supporto dell'ambiente corrente per la gestione del contatto proveniente dai dispositivi di input dell'utente, inclusi i contatti che hanno due o più punti di contatto (ad esempio uno schermo sensibile che l'utente può toccare con più dita). Quando un utente interagisce con un dispositivo, ad esempio un cellulare o un Tablet PC con uno schermo sensibile, in genere tocca lo schermo utilizzando le dita o un dispositivo di puntamento. Sebbene sia disponibile un'ampia gamma di dispositivi di puntamento, ad esempio un mouse o uno stilo, molti di essi hanno un solo punto di contatto con un'applicazione. Per i dispositivi di puntamento con un solo punto di contatto, gli eventi di interazione dell'utente possono essere gestiti come un evento del mouse oppure utilizzando un set di base di eventi di tocco (detti eventi del "punto di contatto"). Per i dispositivi di puntamento con più punti di contatto che eseguono movimenti complessi, come la mano umana, i runtime Flash supportano tuttavia un ulteriore gruppo di API di gestione degli eventi, detti eventi gesto. L'API per la gestione delle interazioni dell'utente con questi eventi gesto include le classi seguenti:

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.

Vedere gli esempi

Altri esempi

Input tocco, multitocco e gestuale

Altre informazioni

Michael Chaize: Tetris, API Touch e Android
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.TouchEvent
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.GesturePhase
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()

Proprietà pubbliche

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

Metodi pubblici

Nascondi metodi pubblici ereditati

Mostra metodi pubblici ereditati

	Metodo		Definito da
		hasOwnProperty(name:String):Boolean Indica se per un oggetto è definita una proprietà specifica.	Object
		isPrototypeOf(theClass:Object):Boolean Indica se un'istanza della classe Object si trova nella catena di prototipi dell'oggetto specificato come parametro.	Object
		propertyIsEnumerable(name:String):Boolean Indica se la proprietà specificata esiste ed è enumerabile.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Imposta la disponibilità di una proprietà dinamica per le operazioni cicliche.	Object
		toLocaleString():String Restituisce la rappresentazione in formato stringa di questo oggetto, formattato in base alle convenzioni specifiche per le versioni localizzate.	Object
		toString():String Restituisce la rappresentazione in formato stringa dell'oggetto specificato.	Object
		valueOf():Object Restituisce il valore di base dell'oggetto specificato.	Object

Descrizione delle proprietà

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):void

Elementi API correlati

flash.ui.MultitouchInputMode

Esempio ( Come utilizzare questo esempio )

L'esempio seguente visualizza un messaggio quando il quadrato disegnato in mySprite viene toccato su uno schermo sensibile:

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):void

Elementi API correlati

TouchEvent
MouseEvent

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():int

Elementi API correlati

flash.events.TouchEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
flash.events.GestureEvent
flash.events.TransformGestureEvent

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

Rilevamento supporto tocco

Elementi API correlati

flash.events.TouchEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
flash.events.GestureEvent
flash.events.PressAndTapGestureEvent
flash.events.TransformGestureEvent

Esempio ( Come utilizzare questo esempio )

L'esempio seguente aggiunge i listener di eventi appropriati per ogni gesto singolo supportato nell'ambiente corrente. Il contenuto dell'array di vettori 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():Boolean

Altri esempi

Rilevamento supporto tocco

Elementi API correlati

flash.events.TransformGestureEvent
flash.events.GestureEvent
flash.events.PressAndTapGestureEvent

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():Boolean

Altri esempi

Rilevamento supporto tocco

Elementi API correlati

flash.events.TouchEvent

Esempi Come utilizzare questo esempio

MultitouchExample.as

L'esempio seguente controlla innanzitutto se gli eventi gesto sono supportati (se il computer non supporta gli eventi gesto, l'array di vettori 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);
                }
            }
        }
    }
}

Note legali | Informativa sulla privacy online

Multitouch - AS3

Pacchettix

Elementi del linguaggio

Appendici

Pacchetto flash.ui

inputMode

mapTouchToMouse

maxTouchPoints

supportedGestures

supportsGestureEvents

supportsTouchEvents