GestureEvent

Paket	flash.events
Klass	public class GestureEvent
Arv	GestureEvent Event Object
Underklasser	PressAndTapGestureEvent, TransformGestureEvent

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10.1, AIR 2, Flash Lite 4

Med klassen GestureEvent kan du hantera flera beröringshändelser på enheter som identifierar komplex användarkontakt med enheten (som att trycka två fingrar mot en pekskärm samtidigt). 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 och flytta över den. Du kan utveckla program som reagerar på den här användarinteraktionen med klasserna GestureEvent och TransformGestureEvent. Skapa händelseavlyssnare med händelsetyperna som definieras här eller i de relaterade klasserna TouchEvent och TransformGestureEvent. 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.

Visa exemplen

Relaterade API-element

flash.ui.Multitouch
flash.events.TouchEvent
flash.events.TransformGestureEvent
flash.events.PressAndTapGestureEvent
flash.events.MouseEvent
flash.events.EventDispatcher.addEventListener()

Publika egenskaper

Dölj ärvda publika egenskaper

Visa ärvda publika egenskaper

	Egenskap		Definieras med
		altKey : Boolean Anger om Alt-tangenten är aktiv (true) eller inaktiv (false).	GestureEvent
		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).	GestureEvent
		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.	GestureEvent
		ctrlKey : Boolean Anger om Ctrl-tangenten är aktiv (true) eller inaktiv (false) i Windows eller Linux.	GestureEvent
		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
		localX : Number Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten.	GestureEvent
		localY : Number Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten.	GestureEvent
		phase : String Ett värde från klassen GesturePhase som anger beröringsgestens förlopp.	GestureEvent
		shiftKey : Boolean Anger om skifttangenten är aktiv (true) eller inaktiv (false).	GestureEvent
		stageX : Number [skrivskyddad] Den vågräta koordinat som händelsen inträffade vid i globala scenkoordinater.	GestureEvent
		stageY : Number [skrivskyddad] Den lodräta koordinat som händelsen inträffade vid i globala scenkoordinater.	GestureEvent
		target : Object [skrivskyddad] Händelsens mål.	Event
		type : String [skrivskyddad] Händelsens typ.	Event

Publika metoder

Dölj ärvda publika metoder

Visa ärvda publika metoder

	Metod		Definieras med
		GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey:Boolean = false) Skapar ett Event-objekt som innehåller information om flera beröringshändelser (som att trycka två fingrar mot en pekskärm samtidigt).	GestureEvent
		clone():Event [åsidosätt] Skapar en kopia av GestureEvent-objektet och ställer in värdet för alla egenskaper så att de matchar originalets egenskaper.	GestureEvent
		formatToString(className:String, ... arguments):String Ett verktyg som används för att implementera metoden toString() i de anpassade klasserna ActionScript 3.0.	Event
		hasOwnProperty(name:String):Boolean Anger om det finns en egenskap angiven för ett objekt.	Object
		isDefaultPrevented():Boolean Kontrollerar om preventDefault()-metoden har anropats för händelsen.	Event
		isPrototypeOf(theClass:Object):Boolean Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter.	Object
		preventDefault():void Avbryter en händelses standardbeteende om det beteendet kan avbrytas.	Event
		propertyIsEnumerable(name:String):Boolean Anger om den angivna egenskapen finns och är uppräkningsbar.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Anger tillgänglighet för en dynamisk egenskap för slingåtgärder.	Object
		stopImmediatePropagation():void Förhindrar behandling av händelsehanterare i den aktuella noden och alla noder som följer den aktuella noden i händelseflödet.	Event
		stopPropagation():void Förhindrar behandling av händelsehanterare i noder som följer den aktuella noden i händelseflödet.	Event
		toLocaleString():String Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner.	Object
		toString():String [åsidosätt] Returnerar en sträng som innehåller alla GestureEvent-objektets egenskaper.	GestureEvent
		updateAfterEvent():void Uppdaterar visningen för Flash-miljön efter att gesthändelsen har bearbetats, om visningslistan skulle ha ändrats av händelsehanteraren.	GestureEvent
		valueOf():Object Returnerar det angivna objektets primitiva värde.	Object

Publika konstanter

Dölj ärvda publika konstanter

Visa ärvda publika konstanter

	Konstant		Definieras med
		GESTURE_TWO_FINGER_TAP : String = "gestureTwoFingerTap" [statisk] Definierar värdet på type-egenskapen i ett GESTURE_TWO_FINGER_TAP-gesthändelseobjekt.	GestureEvent

Egenskapsdetaljer

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:

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

controlKey:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10.1, AIR 2

Anger om Ctrl-tangenten är aktiv i Macintosh, Windows eller Linux.

Implementering
public function get controlKey():Boolean
public function set controlKey(value:Boolean):void

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

localX

egenskap

localX:Number

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 förhållande till behållar-spriten.

Implementering
public function get localX():Number
public function set localX(value:Number):void

localY

egenskap

localY:Number

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 förhållande till behållar-spriten.

Implementering
public function get localY():Number
public function set localY(value:Number):void

phase

egenskap

phase:String

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10.1, AIR 2, Flash Lite 4

Ett värde från klassen GesturePhase som anger beröringsgestens förlopp. För de flesta gester är värdet begin, update eller end. För svepnings- och tvåfingergester är fasvärdet alltid all så snart händelsen har skickats. Använd det här värdet för att ange när en händelsehanterare svarar på en komplex användarinteraktion eller svarar på olika sätt beroende på den aktuella fasen av flera beröringshändelser (t.ex. expandera, flytta och släppa när en användare berör och drar ett visuellt objekt på en skärm).

Implementering
public function get phase():String
public function set phase(value:String):void

Relaterade API-element

flash.events.GesturePhase

shiftKey

egenskap

shiftKey:Boolean

Språkversion:

ActionScript 3.0

Körningsmiljöversioner:

Flash Player 10.1, AIR 2

Anger om skifttangenten är aktiv (true) eller inaktiv (false).

Implementering
public function get shiftKey():Boolean
public function set shiftKey(value:Boolean):void

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

Konstruktordetaljer

()

Konstruktor

public function GestureEvent(type:String, bubbles:Boolean = true, cancelable:Boolean = false, phase:String = null, localX:Number = 0, localY:Number = 0, ctrlKey:Boolean = false, altKey:Boolean = false, shiftKey:Boolean = false, commandKey:Boolean = false, controlKey: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 flera beröringshändelser (som att trycka två fingrar mot en pekskärm samtidigt). Event-objekt skickas som parametrar till händelseavlyssnare.

Parametrar

	`type:String` — Händelsens typ. Värde som stöds: `GestureEvent.GESTURE_TWO_FINGER_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.

	`phase:String` (default = `null`) — Ett värde från klassen GesturePhase, som anger beröringsgestens förlopp (inleds, uppdateras, avslutas eller alla).

	`localX:Number` (default = `0`) — Den vågräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten.

	`localY:Number` (default = `0`) — Den lodräta koordinat som händelsen inträffade vid i förhållande till behållar-spriten.

	`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.

Relaterade API-element

flash.events.GesturePhase

Metoddetaljer

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 GestureEvent-objektet och ställer in värdet för alla egenskaper så att de matchar originalets egenskaper.

Returnerar

Event — Ett nytt GestureEvent-objekt med egenskapsvärden som matchar originalets.

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 GestureEvent-objektets egenskaper. Strängen är i följande format:

[GestureEvent type=värde bubbles=värde cancelable=värde ... ]

Returnerar

String — En sträng som innehåller alla GestureEvent-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

Uppdaterar visningen för Flash-miljön efter att gesthändelsen har bearbetats, om visningslistan skulle ha ändrats av händelsehanteraren.

Konstantdetaljer

GESTURE_TWO_FINGER_TAP

Konstant

public static const GESTURE_TWO_FINGER_TAP:String = "gestureTwoFingerTap"

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 GESTURE_TWO_FINGER_TAP-gesthändelseobjekt.

Det skickade GestureEvent-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`	(Endast AIR) `true` på Mac om Kommando-tangenten är aktiv 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.
`phase`	Den nuvarande fasen i händelseflödet. För tvåfingerhändelser är det här värdet alltid `all`, vilket motsvarar värdet `GesturePhase.ALL` så snart händelsen har skickats.
`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.
`shiftKey`	`true` om skifttangenten är aktiverad eller `false` om den är inaktiverad.
`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.

Relaterade API-element

flash.display.InteractiveObject.gestureTwoFingerTap
flash.events.GesturePhase

Exempel Så här använder du exemplet

GestureTwoFingerTap.as

Följande exempel visar händelsehantering för händelsen GESTURE_TWO_FINGER_TAP. När användaren utför en tvåfingersgest roterar mySprite och myTextField fylls i med fasen all, som är den enda fasen för tvåfingerberöringshändelser. Andra gester från klassen TransformGestureEvent har stöd för inlednings-, uppdaterings- och avslutningsfaser.

Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(GestureEvent.GESTURE_TWO_FINGER_TAP , onTwoFingerTap );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onTwoFingerTap(evt:GestureEvent):void {

    evt.target.rotation -= 45;
    myTextField.text = evt.phase; //"all"

}

Juridiska meddelanden | Onlinesekretesspolicy

GestureEvent - AS3

Klasser x

altKey

commandKey

controlKey

ctrlKey

localX

localY

phase

shiftKey

stageX

stageY

GestureEvent

clone

toString

updateAfterEvent

GESTURE_TWO_FINGER_TAP