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