| Paket | flash.ui |
| Klass | public final class Multitouch |
| Arv | Multitouch Object |
| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
- flash.events.TouchEvent
- flash.events.GestureEvent
- flash.events.GesturePhase
- flash.events.TransformGestureEvent
- flash.events.PressAndTapGestureEvent
Använd de här klasserna för att skiva kod som hanterar beröringshändelser. Använd klassen Multitouch för att fastställa om den aktuella miljön har stöd för beröringsinteraktion och för att hantera det stödet, om det finns.
Du kan inte skapa ett Multitouch-objekt direkt från ActionScript-kod. Om du anropar new Multitouch() genereras ett undantag.
Obs! Funktionen Multitouch stöds inte för HTML-inbäddade SWF-filer på Mac OS.
Lär dig mer
Christian Cantrell: Multitouch and gesture support on the Flash Platform (Stöd för flerberöringsläge och gester på Flash-plattformen)
Lee Brimelow: Flash Player 10.1 multi-touch FAQ (Vanliga frågor och svar om flerpunktsberöring i Flash Player 10.1)
Piotr Walczyszyn: Multitouch development in Flex (Utveckla flerpunktsberöring i Flex)
Relaterade API-element
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.GesturePhase
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
| Egenskap | Definieras med | ||
|---|---|---|---|
![]() | constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | |
| inputMode : String [statisk]
Identifierar flerberöringsläget för hantering av berörings- och gesthändelser. | Multitouch | ||
| mapTouchToMouse : Boolean [statisk]
Anger om AIR-miljön mappar beröringshändelser till mushändelser. | Multitouch | ||
| maxTouchPoints : int [statisk] [skrivskyddad]
Högsta antal samtidiga beröringspunkter som stöds i den aktuella miljön. | Multitouch | ||
| supportedGestures : Vector.<String> [statisk] [skrivskyddad]
En Vector-array (en typbestämd array med strängvärden) med de beröringskontakttyper som stöds i den aktuella miljön. | Multitouch | ||
| supportsGestureEvents : Boolean [statisk] [skrivskyddad]
Anger om den aktuella miljön har stöd för gestindata, som att rotera två fingrar runt en pekskärm. | Multitouch | ||
| supportsTouchEvents : Boolean [statisk] [skrivskyddad]
Anger om den aktuella miljön har stöd för grundläggande beröringsindata, som en enkel beröring med ett finger. | Multitouch | ||
inputMode | egenskap |
inputMode:String| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Identifierar flerberöringsläget för hantering av berörings- och gesthändelser. Använd den här egenskapen för att hantera om händelser ska skickas som beröringshändelser med flera kontaktpunkter och särskilda händelser för olika gester (som rotation eller panorering), som en enda kontaktpunkt (t.ex. en fingerberöring) eller inte skickas alls (kontakten hanteras som en mushändelse). Ange den här egenskapen med värden från klassen flash.ui.MultitouchInputMode.
Standardvärdet är gesture.
Implementering
public static function get inputMode():String public static function set inputMode(value:String):voidRelaterade API-element
Exempel ( Så här använder du exemplet )
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 | egenskap |
mapTouchToMouse:Boolean| Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | AIR 3 |
Anger om AIR-miljön mappar beröringshändelser till mushändelser.
När den är true, standardvärdet, skickar AIR-miljön en mushändelse förutom en beröringshändelse för beröringsinmatningar. När den är false skickar miljön inte någon ytterligare mushändelse. Om du anger att den här egenskapen ska vara false kan befintlig kod och befintliga bibliotek och ramverk fungera felaktigt på enheter med stöd för beröringsinmatningar.
Implementering
public static function get mapTouchToMouse():Boolean public static function set mapTouchToMouse(value:Boolean):voidRelaterade API-element
maxTouchPoints | egenskap |
maxTouchPoints:int [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Högsta antal samtidiga beröringspunkter som stöds i den aktuella miljön.
Obs! På Android är returvärdet 2 för enheter med stöd för fler än två beröringspunkter.
Implementering
public static function get maxTouchPoints():intRelaterade API-element
supportedGestures | egenskap |
supportedGestures:Vector.<String> [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
En Vector-array (en typbestämd array med strängvärden) med de beröringskontakttyper som stöds i den aktuella miljön. Arrayen med strängar kan användas som händelsetyper för att registrera händelseavlyssnare. Möjliga värden är konstanter från klasserna GestureEvent, PressAndTapGestureEvent och TransformGestureEvent (t.ex. GESTURE_PAN).
Om Flash-miljön körs i en miljö som helt saknar stöd för flerberöringsgester är värdet null.
Obs! För Mac OS 10.5.3 och senare returnerar Multitouch.supportedGestures värden som inte är null (vilket felaktigt kan antyda att gesthändelser stöds) trots att den aktuella maskinvaran saknar stöd för gestindata.
Använd den här egenskapen för att testa om flerberöringsgester stöds. Använd sedan händelsehanterare för de tillgängliga flerberöringsgesterna. För gester som inte stöds i den aktuella miljön måste du skapa alternativ händelsehantering.
Implementering
public static function get supportedGestures():Vector.<String>Relaterade API-element
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
flash.events.GestureEvent
flash.events.PressAndTapGestureEvent
flash.events.TransformGestureEvent
Exempel ( Så här använder du exemplet )
Multitouch.supportedGestures-vektorarrayen ändras till att omfatta alla gester som är tillgängliga för den aktuella program- och maskinvarumiljön för Flash-miljön. Om Multitouch.supportedGestures-vektorarrayen inte innehåller någon av TransformGestureEvent-gesterna läggs ingen händelseavlyssnare för den gesten till. Det här exemplet kommer från 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 | egenskap |
supportsGestureEvents:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Anger om den aktuella miljön har stöd för gestindata, som att rotera två fingrar runt en pekskärm. Gesthändelser listas i klasserna TransformGestureEvent, PressAndTapGestureEvent och GestureEvent.
Obs! För Mac OS 10.5.3 och senare är det här värdet alltid true. Multitouch.supportsGestureEvent returnerar true trots att den aktuella maskinvaran saknar stöd för gesthändelser.
Implementering
public static function get supportsGestureEvents():BooleanRelaterade API-element
supportsTouchEvents | egenskap |
supportsTouchEvents:Boolean [skrivskyddad] | Språkversion: | ActionScript 3.0 |
| Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Anger om den aktuella miljön har stöd för grundläggande beröringsindata, som en enkel beröring med ett finger. Beröringshändelser listas i klassen TouchEvent.
Implementering
public static function get supportsTouchEvents():BooleanRelaterade API-element
Multitouch.supportedGestures värdet null, och värdet null för strängvektorn genererar ett körningsfel.) Om gesthändelser stöds visar exemplet de händelser från klassen TransformGestureEvent som stöds i den aktuella miljön:
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, 01:40 PM Z
Dölj ärvda publika egenskaper
Visa ärvda publika egenskaper