Paket | flash.events |
Klass | public class TouchEvent |
Arv | TouchEvent Event Object |
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
När användaren interagerar med en enhet, som en mobiltelefon eller en bärbar dator med pekskärm, använder han eller hon vanligtvis fingrarna eller ett pekdon för att röra vid skärmen. Du kan utveckla program som reagerar på grundläggande beröringshändelser (t.ex. en fingertryckning) med klassen TouchEvent. Skapa händelseavlyssnare med händelsetyperna som definieras i den här klassen. Använd de relaterade klasserna GestureEvent, PressAndTapGestureEvent och TransformGestureEvent för användarinteraktion med flera kontaktpunkter (t.ex. flera fingrar som flyttas över en pekskärm samtidigt). Och du kan använda egenskaperna och metoderna i de här klasserna för att skapa händelsehanterare som svarar när användaren vidrör enheten.
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.
Obs! När objekt är kapslade i visningslistan riktar beröringshändelser in sig på det djupast liggande objektet som syns i visningslistan. Det här objektet kallas målnod. Om du vill att målnodens överordnade objekt (ett objekt som innehåller målnoden i visningslistan) ska ta emot meddelanden om en beröringshändelse använder du EventDispatcher.addEventListener()
på den överordnade noden med type-parametern inställd på den beröringshändelse som du vill identifiera.
I AIR 3, och senare, kan du avlyssna proximity-händelser på kompatibla Android-enheter som har en aktiv penna. På sådana enheter ger händelseobjekten proximityMove
och touchMove
en byte-array som innehåller sökvägs- och tryckvärden efter den senaste move-händelsen. Du kan använda dessa exempel för att konstruera sökvägen för pennan mellan beröringshändelser. (Observera att träfftester för pennindatainteraktion med visningslistan inträffar endast i slutet av ett sökvägssegment.)
Relaterade API-element
flash.events.GestureEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()
Egenskap | Definieras med | ||
---|---|---|---|
altKey : Boolean
Anger om Alt-tangenten är aktiv (true) eller inaktiv (false). | TouchEvent | ||
bubbles : Boolean [skrivskyddad]
indikerar om händelsen är en bubblande händelse. | Event | ||
cancelable : Boolean [skrivskyddad]
Indikerar om beteendet som är kopplat till händelsen kan förhindras. | Event | ||
commandKey : Boolean
Anger om kommandotangenten är aktiverad (endast Macintosh). | TouchEvent | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
controlKey : Boolean
Anger om Ctrl-tangenten är aktiv i Macintosh, Windows eller Linux. | TouchEvent | ||
ctrlKey : Boolean
Anger om Ctrl-tangenten är aktiv (true) eller inaktiv (false) i Windows eller Linux. | TouchEvent | ||
currentTarget : Object [skrivskyddad]
Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. | Event | ||
eventPhase : uint [skrivskyddad]
Den nuvarande fasen i händelseflödet. | Event | ||
isPrimaryTouchPoint : Boolean
Anger om den första kontaktpunkten har mappats till mushändelser. | TouchEvent | ||
isRelatedObjectInaccessible : Boolean
Om true, är egenskapen relatedObject satt till null av orsaker som är relaterade till säkerhetssandlådor. | TouchEvent | ||
isTouchPointCanceled : Boolean
Rapporterar att denna beröringsindatasekvens har avbrutits av operativsystemet. | TouchEvent | ||
localX : Number
Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. | TouchEvent | ||
localY : Number
Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. | TouchEvent | ||
pressure : Number
Ett värde mellan 0.0 och 1.0, som anger kontaktens styrka (mot enheten). | TouchEvent | ||
relatedObject : InteractiveObject
En referens till ett visningslisteobjekt som är relaterat till händelsen. | TouchEvent | ||
shiftKey : Boolean
Anger om skifttangenten är aktiv (true) eller inaktiv (false). | TouchEvent | ||
sizeX : Number
Kontaktområdets bredd. | TouchEvent | ||
sizeY : Number
Kontaktområdets höjd. | TouchEvent | ||
stageX : Number [skrivskyddad]
Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. | TouchEvent | ||
stageY : Number [skrivskyddad]
Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. | TouchEvent | ||
target : Object [skrivskyddad]
Händelsens mål. | Event | ||
timestamp : Number
Rapporterar tiden för händelsen i relativa millisekunder. | TouchEvent | ||
touchIntent : String
Rapporterar om beröringen genererades av den primära änden eller av suddgummiänden på en penna. | TouchEvent | ||
touchPointID : int
Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. | TouchEvent | ||
type : String [skrivskyddad]
Händelsens typ. | Event |
Metod | Definieras med | ||
---|---|---|---|
TouchEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, touchPointID:int = 0, isPrimaryTouchPoint:Boolean = false, localX:Number = NaN, localY:Number = NaN, sizeX:Number = NaN, sizeY:Number = NaN, pressure:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, timestamp:Number = NaN, touchIntent:String, samples:ByteArray = null, isTouchPointCanceled:Boolean = false)
Skapar ett Event-objekt som innehåller information om beröringshändelser. | TouchEvent | ||
[åsidosätt]
Skapar en kopia av TouchEvent-objektet och ställer in värdet för alla egenskaper så att de matchar originalets egenskaper. | TouchEvent | ||
Ett verktyg som används för att implementera metoden toString() i de anpassade klasserna ActionScript 3.0. | Event | ||
Uppdaterar det angivna ByteArray-objektet med högfrekventa datapunkter för en beröringshändelse för flera punkter. | TouchEvent | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Kontrollerar om preventDefault()-metoden har anropats för händelsen. | Event | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Rapporterar att maskinvaruknappen för ett speciellt index trycks ned. | TouchEvent | ||
Avbryter en händelses standardbeteende om det beteendet kan avbrytas. | Event | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Förhindrar behandling av händelsehanterare i den aktuella noden och alla noder som följer den aktuella noden i händelseflödet. | Event | ||
Förhindrar behandling av händelsehanterare i noder som följer den aktuella noden i händelseflödet. | Event | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
[åsidosätt]
Returnerar en sträng som innehåller alla TouchEvent-objektets egenskaper. | TouchEvent | ||
Instruerar Flash Player eller Adobe AIR att göra en rendering när den här händelsen har behandlats, om visningslistan har ändrats. | TouchEvent | ||
Returnerar det angivna objektets primitiva värde. | Object |
Konstant | Definieras med | ||
---|---|---|---|
PROXIMITY_BEGIN : String = "proximityBegin" [statisk]
Definierar värdet på egenskapen type för ett PROXIMITY_BEGIN-beröringshändelseobjekt. | TouchEvent | ||
PROXIMITY_END : String = "proximityEnd" [statisk]
Definierar värdet på egenskapen type för ett PROXIMITY_END-beröringshändelseobjekt. | TouchEvent | ||
PROXIMITY_MOVE : String = "proximityMove" [statisk]
Definierar värdet på egenskapen type för ett PROXIMITY_MOVE-beröringshändelseobjekt. | TouchEvent | ||
PROXIMITY_OUT : String = "proximityOut" [statisk]
Definierar värdet på egenskapen type för ett PROXIMITY_OUT-beröringshändelseobjekt. | TouchEvent | ||
PROXIMITY_OVER : String = "proximityOver" [statisk]
Definierar värdet på egenskapen type för ett PROXIMITY_OUT-beröringshändelseobjekt. | TouchEvent | ||
PROXIMITY_ROLL_OUT : String = "proximityRollOut" [statisk]
Definierar värdet på egenskapen type för ett PROXIMITY_ROLL_OUT-beröringshändelseobjekt. | TouchEvent | ||
PROXIMITY_ROLL_OVER : String = "proximityRollOver" [statisk]
Definierar värdet på egenskapen type för ett PROXIMITY_ROLL_OVER-beröringshändelseobjekt. | TouchEvent | ||
TOUCH_BEGIN : String = "touchBegin" [statisk]
Definierar värdet på type-egenskapen i ett TOUCH_BEGIN-beröringshändelseobjekt. | TouchEvent | ||
TOUCH_END : String = "touchEnd" [statisk]
Definierar värdet på type-egenskapen i ett TOUCH_END-beröringshändelseobjekt. | TouchEvent | ||
TOUCH_MOVE : String = "touchMove" [statisk]
Definierar värdet på type-egenskapen i ett TOUCH_MOVE-beröringshändelseobjekt. | TouchEvent | ||
TOUCH_OUT : String = "touchOut" [statisk]
Definierar värdet på type-egenskapen i ett TOUCH_OUT-beröringshändelseobjekt. | TouchEvent | ||
TOUCH_OVER : String = "touchOver" [statisk]
Definierar värdet på type-egenskapen i ett TOUCH_OVER-beröringshändelseobjekt. | TouchEvent | ||
TOUCH_ROLL_OUT : String = "touchRollOut" [statisk]
Definierar värdet på type-egenskapen i ett TOUCH_ROLL_OUT-beröringshändelseobjekt. | TouchEvent | ||
TOUCH_ROLL_OVER : String = "touchRollOver" [statisk]
Definierar värdet på type-egenskapen i ett TOUCH_ROLL_OVER-beröringshändelseobjekt. | TouchEvent | ||
TOUCH_TAP : String = "touchTap" [statisk]
Definierar värdet på type-egenskapen i ett TOUCH_TAP-beröringshändelseobjekt. | TouchEvent |
altKey | egenskap |
altKey:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Anger om Alt-tangenten är aktiv (true
) eller inaktiv (false
). Stöds bara för operativsystemen Windows och Linux.
Implementering
public function get altKey():Boolean
public function set altKey(value:Boolean):void
commandKey | egenskap |
commandKey:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Anger om kommandotangenten är aktiverad (endast Macintosh).
På Mac OS är värdet för egenskapen commandKey
samma som för egenskapen ctrlKey
. Den här egenskapen är alltid false på Windows och Linux.
Implementering
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void
controlKey | egenskap |
ctrlKey | egenskap |
ctrlKey:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2 |
Anger om Ctrl-tangenten är aktiv (true
) eller inaktiv (false
) i Windows eller Linux. Anger om Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh.
Implementering
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void
isPrimaryTouchPoint | egenskap |
isPrimaryTouchPoint:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Anger om den första kontaktpunkten har mappats till mushändelser.
Implementering
public function get isPrimaryTouchPoint():Boolean
public function set isPrimaryTouchPoint(value:Boolean):void
Relaterade API-element
isRelatedObjectInaccessible | egenskap |
isRelatedObjectInaccessible:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Om true
, är egenskapen relatedObject
satt till null
av orsaker som är relaterade till säkerhetssandlådor. Om det nominella värdet för relatedObject
är en referens till ett DisplayObject i en annan sandlåda, är relatedObject
satt till null
om det inte finns behörighet i båda riktningar över den här sandlådegränsen. Behörighet etableras genom att anropa Security.allowDomain()
från en SWF-fil, eller genom att tillhandahålla en principfil för en server för en bildfil och ställa in egenskapen LoaderContext.checkPolicyFile
under inläsning av bilden.
Implementering
public function get isRelatedObjectInaccessible():Boolean
public function set isRelatedObjectInaccessible(value:Boolean):void
Relaterade API-element
isTouchPointCanceled | egenskap |
isTouchPointCanceled:Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Rapporterar att denna beröringsindatasekvens har avbrutits av operativsystemet.
Beröringshändelser kan avbrytas av olika anledningar, till exempel när en handflategenererad beröring avvisas på grund av att en penna används. isTouchPointCanceled
kan endast vara true
i en touchEnd
-händelse.
Implementering
public function get isTouchPointCanceled():Boolean
public function set isTouchPointCanceled(value:Boolean):void
localX | egenskap |
localY | egenskap |
pressure | egenskap |
pressure:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Ett värde mellan 0.0
och 1.0
, som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0
.
Implementering
public function get pressure():Number
public function set pressure(value:Number):void
relatedObject | egenskap |
relatedObject:InteractiveObject
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
En referens till ett visningslisteobjekt som är relaterat till händelsen. När exempelvis en touchOut
-händelse inträffar motsvarar relatedObject
det objekt i visningslistan som pekaren nu pekar på. Egenskapen tillämpas på händelserna touchOut
, touchOver
, touchRollOut
och touchRollOver
.
Värdet för den här egenskapen kan vara null
under två förhållanden: om det inte finns något relaterat objekt, eller om det finns ett relaterat objekt, men i en säkerhetssandlåda som du inte har tillgång till. Använd egenskapen isRelatedObjectInaccessible()
för att avgöra vilken av dessa orsaker det är som gäller.
Implementering
public function get relatedObject():InteractiveObject
public function set relatedObject(value:InteractiveObject):void
Relaterade API-element
shiftKey | egenskap |
sizeX | egenskap |
sizeY | egenskap |
stageX | egenskap |
stageX:Number
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. Den här egenskapen beräknas när egenskapen för localX
har ställts in.
Implementering
public function get stageX():Number
stageY | egenskap |
stageY:Number
[skrivskyddad] Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. Den här egenskapen beräknas när egenskapen för localY
har ställts in.
Implementering
public function get stageY():Number
timestamp | egenskap |
timestamp:Number
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Rapporterar tiden för händelsen i relativa millisekunder.
De rapporterade tiderna är relativa till tiden då programkörningen startades. För händelser som returnerar en punktsekvens i sampelbufferten, kommer denna tidsstämpel att visa den tid som förflutit för det senaste samplet i bufferten.
Implementering
public function get timestamp():Number
public function set timestamp(value:Number):void
Relaterade API-element
touchIntent | egenskap |
touchIntent:String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Rapporterar om beröringen genererades av den primära änden eller av suddgummiänden på en penna.
Om en beröringshändelse genereras av ett finger eller ett annat föremål som inte är en penna, eller en penna för vilken högfrekvent rörelsespårning inte stöds, kommer den här egenskapen att rapportera värdet: TouchEventIntent.UNKNOWN.
Klassen TouchEventIntent definierar konstanter för tänkbara värden för denna egenskap, vilka omfattar:
- TouchEventIntent.ERASER
- TouchEventIntent.PEN
- TouchEventIntent.UNKNOWN
Implementering
public function get touchIntent():String
public function set touchIntent(value:String):void
Relaterade API-element
touchPointID | egenskap |
touchPointID:int
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten.
Implementering
public function get touchPointID():int
public function set touchPointID(value:int):void
Exempel ( Så här använder du exemplet )
touchMoveID
för att testa korrekt touchPointID
-värde innan en berörings-/flyttningshändelse besvaras. Annars utlöser andra beröringsindata också händelsehanteraren. Lägg märke till att avlyssnarna för flyttnings- och slutfaserna är på scenen, inte visningsobjektet. Scenen lyssnar efter flyttnings- och slutfaserna ifall användarens beröring skulle gå utanför visningsobjektets gränser.
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; var mySprite:Sprite = new Sprite(); mySprite.graphics.beginFill(0x336699); mySprite.graphics.drawRect(0,0,40,40); addChild(mySprite); var myTextField:TextField = new TextField(); addChild(myTextField); myTextField.width = 200; myTextField.height = 20; var touchMoveID:int = 0; mySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); function onTouchBegin(event:TouchEvent) { if(touchMoveID != 0) { myTextField.text = "already moving. ignoring new touch"; return; } touchMoveID = event.touchPointID; myTextField.text = "touch begin" + event.touchPointID; stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); } function onTouchMove(event:TouchEvent) { if(event.touchPointID != touchMoveID) { myTextField.text = "ignoring unrelated touch"; return; } mySprite.x = event.stageX; mySprite.y = event.stageY; myTextField.text = "touch move" + event.touchPointID; } function onTouchEnd(event:TouchEvent) { if(event.touchPointID != touchMoveID) { myTextField.text = "ignoring unrelated touch end"; return; } touchMoveID = 0; stage.removeEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); stage.removeEventListener(TouchEvent.TOUCH_END, onTouchEnd); myTextField.text = "touch end" + event.touchPointID; }
TouchEvent | () | Konstruktor |
public function TouchEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, touchPointID:int = 0, isPrimaryTouchPoint:Boolean = false, localX:Number = NaN, localY:Number = NaN, sizeX:Number = NaN, sizeY:Number = NaN, pressure:Number = NaN, relatedObject:InteractiveObject = null, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false, timestamp:Number = NaN, touchIntent:String, samples:ByteArray = null, isTouchPointCanceled:Boolean = false)
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Skapar ett Event-objekt som innehåller information om beröringshändelser. Event-objekt skickas som parametrar till händelseavlyssnare.
Parametrartype:String — Händelsens typ. Möjliga värden är: TouchEvent.PROXIMITY_BEGIN , TouchEvent.PROXIMITY_END , TouchEvent.PROXIMITY_MOVE , TouchEvent.PROXIMITY_OUT , TouchEvent.PROXIMITY_OVER , TouchEvent.PROXIMITY_ROLL_OUT , TouchEvent.PROXIMITY_ROLL_OVER , TouchEvent.TOUCH_BEGIN , TouchEvent.TOUCH_END , TouchEvent.TOUCH_MOVE , TouchEvent.TOUCH_OUT , TouchEvent.TOUCH_OVER , TouchEvent.TOUCH_ROLL_OUT , TouchEvent.TOUCH_ROLL_OVER och TouchEvent.TOUCH_TAP .
| |
bubbles:Boolean (default = true ) — Bestämmer om Event-objektet deltar i bubblingsfasen av händelseflödet.
| |
cancelable:Boolean (default = false ) — Avgör om Event-objektet kan avbrytas.
| |
touchPointID:int (default = 0 ) — Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten.
| |
isPrimaryTouchPoint:Boolean (default = false ) — Anger om den första kontaktpunkten har mappats till mushändelser.
| |
localX:Number (default = NaN ) — Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten.
| |
localY:Number (default = NaN ) — Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten.
| |
sizeX:Number (default = NaN ) — Kontaktområdets bredd.
| |
sizeY:Number (default = NaN ) — Kontaktområdets höjd.
| |
pressure:Number (default = NaN ) — Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 .
| |
relatedObject:InteractiveObject (default = null ) — Den kompletterande InteractiveObject-instansen som påverkas av händelsen. När exempelvis en touchOut -händelse inträffar motsvarar relatedObject det objekt i visningslistan som pekaren nu pekar på.
| |
ctrlKey:Boolean (default = false ) — Anger om Ctrl-tangenten är aktiv i Windows eller Linux. Anger om Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh.
| |
altKey:Boolean (default = false ) — Anger om Alt-tangenten är aktiverad (endast Windows och Linux).
| |
shiftKey:Boolean (default = false ) — Anger om skifttangenten är aktiverad.
| |
commandKey:Boolean (default = false ) — (Endast AIR) Anger om Kommando-tangenten är aktiverad (endast Mac). Den här parametern gäller endast Adobe AIR. Använd den inte för Flash Player-innehåll.
| |
controlKey:Boolean (default = false ) — (Endast AIR) Anger om Ctrl-tangenten är aktiverad. Den här parametern gäller endast Adobe AIR. Använd den inte för Flash Player-innehåll.
| |
timestamp:Number (default = NaN ) — (Endast AIR) Tidsstämpeln för händelsen i millisekunder relativt till programmets start.
| |
touchIntent:String (default = NaN ) — (Endast AIR) Ett värde från klassen TouchEventIntent.
| |
samples:ByteArray (default = null ) — (Endast AIR) Ett ByteArray-objekt som innehåller positions- och tryckvärden för varje mellanliggande inspelat sampel efter den senaste beröringen eller proximity-händelsen i en sekvens.
| |
isTouchPointCanceled:Boolean (default = false ) — (Endast AIR) true om beröringshändelsen har avbrutits på grund av en avvisad beröringstyp.
|
clone | () | metod |
override public function clone():Event
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Skapar en kopia av TouchEvent-objektet och ställer in värdet för alla egenskaper så att de matchar originalets egenskaper.
ReturnerarEvent — Ett nytt TouchEvent-objekt med egenskapsvärden som matchar originalets.
|
getSamples | () | metod |
public function getSamples(buffer:ByteArray, append:Boolean = false):uint
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Uppdaterar det angivna ByteArray-objektet med högfrekventa datapunkter för en beröringshändelse för flera punkter.
Objektet ByteArray som refereras av parametern buffer
uppdateras med värden för de mellanliggande datapunkterna mellan denna och tidigare beröringshändelser. Tre flyttalsvärden läggs till i varje sampel: en x-koordinat, en y-koordinat och ett tryckvärde. Positionsvärdena som rapporteras i scenkoordinaterna. Trycket rapporteras som ett värde mellan 0 och 1. Sampel registreras med jämna tidsintervall. Den exakta frekvensen beror på enhetens maskinvara och drivrutiner. Vanliga samplingfrekvenser ligger runt 133 Hz. Observera att beröringshändelser inte skickas med jämna mellanrum. Således kan bufferten för liknande händelser innehålla olika antal sampel. Det sista samplet i bufferten innehåller samma data som egenskaperna stageX
, stageY
och pressure
i detta beröringshändelseobjekt.
En samplingsbuffert inkluderas i händelseobjekten som skickas för händelserna proximityMove
och touchMove
.
Parametrar
buffer:ByteArray — ByteArray-objektet som ska erhålla sampeldata.
| |
append:Boolean (default = false ) — när true , samplen är tillagda till början av buffer -byte-arrayen vid arrayens aktuella position -egenskap. Vid false , standard, kommer befintliga data i buffertobjektet att ignoreras innan samplen läggs till.
|
uint — uint antalet sampel tillagda i bufferten. Varje sampel består av tre flyttal.
|
Relaterade API-element
Exempel ( Så här använder du exemplet )
function touchMoveHandler( event:TouchEvent ):void { if( (event.type == TouchEvent.TOUCH_MOVE || event.type == TouchEvent.PROXIMITY_MOVE) && event.touchEventIntent != TouchEventIntent.UNKNOWN ) { var samples:ByteArray = new ByteArray(); event.getSamples( samples, true ); samples.position = 0; // rewind to beginning of array before reading var xCoord:Number, yCoord:Number, pressure:Number; while( samples.bytesAvailable > 0 ) { xCoord = samples.readFloat(); yCoord = samples.readFloat(); pressure = samples.readFloat(); //do something with the sample data } } }
var samples:ByteArray = new ByteArray(); function touchMoveHandler( event:TouchEvent ):void { if( (event.type == TouchEvent.TOUCH_MOVE || event.type == TouchEvent.PROXIMITY_MOVE) && event.touchEventIntent != TouchEventIntent.UNKNOWN ) { var sampleCount:uint = event.getSamples( samples, true ); var xCoord:Number, yCoord:Number, pressure:Number; for( var i:int; i < sampleCount; i++ ) { xCoord = samples.readFloat(); yCoord = samples.readFloat(); pressure = samples.readFloat(); //do something with the sample data } } }
isToolButtonDown | () | metod |
public function isToolButtonDown(index:int):Boolean
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Rapporterar att maskinvaruknappen för ett speciellt index trycks ned.
Parametrar
index:int — det nollbaserade indexet för knapparma som stöds av en pennliknande indataenhet.
|
Boolean |
toString | () | metod |
override public function toString():String
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Returnerar en sträng som innehåller alla TouchEvent-objektets egenskaper. Strängen är i följande format:
[TouchEvent type=värde bubbles=värde cancelable=värde ... ]
String — En sträng som innehåller alla TouchEvent-objektets egenskaper.
|
updateAfterEvent | () | metod |
public function updateAfterEvent():void
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Instruerar Flash Player eller Adobe AIR att göra en rendering när den här händelsen har behandlats, om visningslistan har ändrats.
PROXIMITY_BEGIN | Konstant |
public static const PROXIMITY_BEGIN:String = "proximityBegin"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Definierar värdet på egenskapen type
för ett PROXIMITY_BEGIN
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
timestamp | (Endast AIR) Tidsstämpeln för händelsen i millisekunder relativt till programmets start. |
touchIntent | (Endast AIR) Ett värde från klassen TouchEventIntent. |
isTouchPointCanceled | (Endast AIR) true om beröringshändelsen avbryts på grund av enhetens logik för beröringsavslag. |
Relaterade API-element
PROXIMITY_END | Konstant |
public static const PROXIMITY_END:String = "proximityEnd"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Definierar värdet på egenskapen type
för ett PROXIMITY_END
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
timestamp | (Endast AIR) Tidsstämpeln för händelsen i millisekunder relativt till programmets start. |
touchIntent | (Endast AIR) Ett värde från klassen TouchEventIntent. |
isTouchPointCanceled | (Endast AIR) true om beröringshändelsen avbryts på grund av enhetens logik för beröringsavslag. |
Relaterade API-element
PROXIMITY_MOVE | Konstant |
public static const PROXIMITY_MOVE:String = "proximityMove"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Definierar värdet på egenskapen type
för ett PROXIMITY_MOVE
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
timestamp | (Endast AIR) Tidsstämpeln för händelsen i millisekunder relativt till programmets start. |
touchIntent | (Endast AIR) Ett värde från klassen TouchEventIntent. |
isTouchPointCanceled | (Endast AIR) true om beröringshändelsen avbryts på grund av enhetens logik för beröringsavslag. |
Relaterade API-element
PROXIMITY_OUT | Konstant |
public static const PROXIMITY_OUT:String = "proximityOut"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Definierar värdet på egenskapen type
för ett PROXIMITY_OUT
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
timestamp | (Endast AIR) Tidsstämpeln för händelsen i millisekunder relativt till programmets start. |
touchIntent | (Endast AIR) Ett värde från klassen TouchEventIntent. |
isTouchPointCanceled | (Endast AIR) true om beröringshändelsen avbryts på grund av enhetens logik för beröringsavslag. |
Relaterade API-element
PROXIMITY_OVER | Konstant |
public static const PROXIMITY_OVER:String = "proximityOver"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Definierar värdet på egenskapen type
för ett PROXIMITY_OUT
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
timestamp | (Endast AIR) Tidsstämpeln för händelsen i millisekunder relativt till programmets start. |
touchIntent | (Endast AIR) Ett värde från klassen TouchEventIntent. |
isTouchPointCanceled | (Endast AIR) true om beröringshändelsen avbryts på grund av enhetens logik för beröringsavslag. |
Relaterade API-element
PROXIMITY_ROLL_OUT | Konstant |
public static const PROXIMITY_ROLL_OUT:String = "proximityRollOut"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Definierar värdet på egenskapen type
för ett PROXIMITY_ROLL_OUT
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
timestamp | (Endast AIR) Tidsstämpeln för händelsen i millisekunder relativt till programmets start. |
touchIntent | (Endast AIR) Ett värde från klassen TouchEventIntent. |
isTouchPointCanceled | (Endast AIR) true om beröringshändelsen avbryts på grund av enhetens logik för beröringsavslag. |
Relaterade API-element
PROXIMITY_ROLL_OVER | Konstant |
public static const PROXIMITY_ROLL_OVER:String = "proximityRollOver"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | AIR 3 |
Definierar värdet på egenskapen type
för ett PROXIMITY_ROLL_OVER
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
timestamp | (Endast AIR) Tidsstämpeln för händelsen i millisekunder relativt till programmets start. |
touchIntent | (Endast AIR) Ett värde från klassen TouchEventIntent. |
isTouchPointCanceled | (Endast AIR) true om beröringshändelsen avbryts på grund av enhetens logik för beröringsavslag. |
Relaterade API-element
TOUCH_BEGIN | Konstant |
public static const TOUCH_BEGIN:String = "touchBegin"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definierar värdet på type
-egenskapen i ett TOUCH_BEGIN
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
Relaterade API-element
TOUCH_END | Konstant |
public static const TOUCH_END:String = "touchEnd"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definierar värdet på type
-egenskapen i ett TOUCH_END
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
Relaterade API-element
TOUCH_MOVE | Konstant |
public static const TOUCH_MOVE:String = "touchMove"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definierar värdet på type
-egenskapen i ett TOUCH_MOVE
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
Relaterade API-element
TOUCH_OUT | Konstant |
public static const TOUCH_OUT:String = "touchOut"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definierar värdet på type
-egenskapen i ett TOUCH_OUT
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
Relaterade API-element
TOUCH_OVER | Konstant |
public static const TOUCH_OVER:String = "touchOver"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definierar värdet på type
-egenskapen i ett TOUCH_OVER
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
Relaterade API-element
TOUCH_ROLL_OUT | Konstant |
public static const TOUCH_ROLL_OUT:String = "touchRollOut"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definierar värdet på type
-egenskapen i ett TOUCH_ROLL_OUT
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
Relaterade API-element
TOUCH_ROLL_OVER | Konstant |
public static const TOUCH_ROLL_OVER:String = "touchRollOver"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definierar värdet på type
-egenskapen i ett TOUCH_ROLL_OVER
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
Relaterade API-element
TOUCH_TAP | Konstant |
public static const TOUCH_TAP:String = "touchTap"
Språkversion: | ActionScript 3.0 |
Körningsmiljöversioner: | Flash Player 10.1, AIR 2, Flash Lite 4 |
Definierar värdet på type
-egenskapen i ett TOUCH_TAP
-beröringshändelseobjekt.
Det skickade TouchEvent-objektet har följande egenskaper:
Egenskap | Värde |
---|---|
altKey | true om Alt-tangenten är aktiv (Windows eller Linux). |
bubbles | true |
cancelable | false ; det finns inget standardbeteende att avbryta. |
commandKey | true om Kommando-tangenten är aktiv i Mac och false om den är inaktiv. Alltid false i Windows. |
controlKey | true om Ctrl-tangenten är aktiv och false om den är inaktiv. |
ctrlKey | true i Windows eller Linux om Ctrl-tangenten är aktiv. true om antingen Ctrl-tangenten eller Kommando-tangenten är aktiv i Macintosh. Annars false . |
currentTarget | Det objekt som aktivt behandlar Event-objektet med en händelseavlyssnare. |
eventPhase | Den nuvarande fasen i händelseflödet. |
isRelatedObjectInaccessible | true om egenskapen relatedObject är null på grund av regler för säkerhetssandlådor. |
localX | Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
localY | Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten. |
pressure | Ett värde mellan 0.0 och 1.0 , som anger kontaktens styrka (mot enheten). Om enheten saknar stöd för att identifiera tryck är värdet 1.0 . |
relatedObject | En referens till ett objekt i visningslistan som rör händelsen. |
shiftKey | true om skifttangenten är aktiverad eller false om den är inaktiverad. |
sizeX | Kontaktområdets bredd. |
sizeY | Kontaktområdets höjd. |
stageX | Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
stageY | Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater. |
target | InteractiveObject-instansen under pekenheten. target är inte alltid det objekt i visningslistan som har registrerat händelseavlyssnaren. Använd egenskapen currentTarget om du vill komma åt det objekt i visningslistan som bearbetar händelsen. |
touchPointID | Ett unikt ID-nummer (som ett int) som tilldelats beröringspunkten. |
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); }
TOUCH_BEGIN
, TOUCH_MOVE
och TOUCH_END
. När kontaktpunkten rör sig över skärmen (onTouchMove
) spåras x-koordinaten i förhållande till scenen till utdata. För Sprite.startTouchDrag
-parametrarna i funktionen onTouchBegin
är värdet för touchPointID det värde som tilldelats händelseobjektet. Parametern bounds är den rektangel som definierar gränserna för det överordnade visningsobjektet (bg är ett visningsobjekt som innehåller MySprite).
Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; MySprite.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); MySprite.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); MySprite.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); function onTouchBegin(eBegin:TouchEvent) { eBegin.target.startTouchDrag(eBegin.touchPointID, false, bg.getRect(this)); trace("touch begin"); } function onTouchMove(eMove:TouchEvent) { trace(eMove.stageX); } function onTouchEnd(eEnd:TouchEvent) { eEnd.target.stopTouchDrag(eEnd.touchPointID); trace("touch end"); }
Multitouch.maxTouchPoints
och beröringshändelseobjektets touchPointID
-egenskaper. Det här exemplet kommer från Christian Cantrell och förklaras mer detaljerat i hans guide: Stöd för flerberöringsläge och gester på Flash-plattformen.
package { import flash.display.Sprite; import flash.events.TouchEvent; import flash.text.AntiAliasType; import flash.text.TextField; import flash.text.TextFormat; import flash.ui.Multitouch; import flash.ui.MultitouchInputMode; [SWF(width=320, height=460, frameRate=24, backgroundColor=0xEB7F00)] public class TouchExample2 extends Sprite { private var dots:Object; private var labels:Object; private var labelFormat:TextFormat; private var dotCount:uint; private var dotsLeft:TextField; private static const LABEL_SPACING:uint = 15; public function TouchExample2() { super(); this.labelFormat = new TextFormat(); labelFormat.color = 0xACF0F2; labelFormat.font = "Helvetica"; labelFormat.size = 11; this.dotCount = 0; this.dotsLeft = new TextField(); this.dotsLeft.width = 300; this.dotsLeft.defaultTextFormat = this.labelFormat; this.dotsLeft.x = 3; this.dotsLeft.y = 0; this.stage.addChild(this.dotsLeft); this.updateDotsLeft(); this.dots = new Object(); this.labels = new Object(); Multitouch.inputMode = MultitouchInputMode.TOUCH_POINT; this.stage.addEventListener(TouchEvent.TOUCH_BEGIN, onTouchBegin); this.stage.addEventListener(TouchEvent.TOUCH_MOVE, onTouchMove); this.stage.addEventListener(TouchEvent.TOUCH_END, onTouchEnd); } private function onTouchBegin(e:TouchEvent):void { if (this.dotCount == Multitouch.maxTouchPoints) return; var dot:Sprite = this.getCircle(); dot.x = e.stageX; dot.y = e.stageY; this.stage.addChild(dot); dot.startTouchDrag(e.touchPointID, true); this.dots[e.touchPointID] = dot; ++this.dotCount; var label:TextField = this.getLabel(e.stageX + ", " + e.stageY); label.x = 3; label.y = this.dotCount * LABEL_SPACING; this.stage.addChild(label); this.labels[e.touchPointID] = label; this.updateDotsLeft(); } private function onTouchMove(e:TouchEvent):void { var label:TextField = this.labels[e.touchPointID]; label.text = (e.stageX + ", " + e.stageY); } private function onTouchEnd(e:TouchEvent):void { var dot:Sprite = this.dots[e.touchPointID]; var label:TextField = this.labels[e.touchPointID]; this.stage.removeChild(dot); this.stage.removeChild(label); delete this.dots[e.touchPointID]; delete this.labels[e.touchPointID]; --this.dotCount; this.updateDotsLeft(); } private function getCircle(circumference:uint = 40):Sprite { var circle:Sprite = new Sprite(); circle.graphics.beginFill(0x1695A3); circle.graphics.drawCircle(0, 0, circumference); return circle; } private function getLabel(initialText:String):TextField { var label:TextField = new TextField(); label.defaultTextFormat = this.labelFormat; label.selectable = false; label.antiAliasType = AntiAliasType.ADVANCED; label.text = initialText; return label; } private function updateDotsLeft():void { this.dotsLeft.text = "Touches Remaining: " + (Multitouch.maxTouchPoints - this.dotCount); } } }
Tue Jun 12 2018, 01:40 PM Z