GestureEvent

Pakket	flash.events
Klasse	public class GestureEvent
Overerving	GestureEvent Event Object
Subklassen	PressAndTapGestureEvent, TransformGestureEvent

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

Met de GestureEvent-klasse kunt u gebeurtenissen met meerdere aanraakbewegingen verwerken op apparaten die complexe gebruikerscontacten met het apparaat detecteren (zoals wanneer er tegelijkertijd met twee vingers op een touchscreen wordt gedrukt). Wanneer een gebruiker communiceert met een apparaat, zoals een gsm of een scherm met touchscreen, raakt de gebruiker normaal gezien het scherm aan en beweegt deze erover met zijn of haar vingers of een aanwijsapparaat. U kunt toepassingen ontwikkelen, die reageren op deze gebruikersinteractie met de klassen GestureEvent en TransformGestureEvent. Maak gebeurtenislisteners met de gebeurtenistypen die hier of in de verwante TouchEvent- en TransformGestureEvent-klassen zijn gedefinieerd. Gebruik de eigenschappen en methoden van deze klassen om gebeurtenisbedieningen samen te stellen die reageren wanneer de gebruiker het apparaat aanraakt.

Gebruik de Multitouch-klasse om de huidige omgevingsondersteuning voor aanraakinteractie te bepalen en om de ondersteuning van aanraakinteractie te beheren als deze wordt ondersteund door de huidige omgeving.

Opmerking: wanneer objecten op de weergavelijst genest zijn, verwijzen aanraakgebeurtenissen naar het diepst mogelijke geneste object dat zichtbaar is op de weergavelijst. Dit object wordt het doelknooppunt genoemd. Als u wilt dat een ancestor van een doelknooppunt (een object met het doelknooppunt in de weergavelijst) melding ontvangt van een aanraakgebeurtenis, gebruikt u EventDispatcher.addEventListener() op het ancestorknooppunt met de typeparameter ingesteld op de specifieke aanraakgebeurtenis die u wilt detecteren.

Bekijk de voorbeelden

Verwante API-elementen

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

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		altKey : Boolean Geeft aan of de Alt-toets actief (true) of inactief (false) is.	GestureEvent
		bubbles : Boolean [alleen-lezen] Geeft aan of een gebeurtenis een terugkoppelgebeurtenis is.	Event
		cancelable : Boolean [alleen-lezen] Geeft aan of het gedrag dat aan deze gebeurtenis is gekoppeld, kan worden voorkomen.	Event
		commandKey : Boolean Geeft aan of de Command-toets is geactiveerd (alleen Macintosh).	GestureEvent
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object
		controlKey : Boolean Hiermee wordt aangegeven of de Control-toets actief is op de Mac en of de Ctrl-toets actief is voor Windows of Linux.	GestureEvent
		ctrlKey : Boolean In Windows of Linux wordt hiermee aangegeven of de Ctrl-toets actief (true) of inactief (false) is.	GestureEvent
		currentTarget : Object [alleen-lezen] Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.	Event
		eventPhase : uint [alleen-lezen] De huidige fase in de gebeurtenisstroom.	Event
		localX : Number De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden ten opzichte van de omvattende sprite.	GestureEvent
		localY : Number De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden ten opzichte van de omvattende sprite.	GestureEvent
		phase : String Een waarde van de klasse GesturePhase die de voortgang van de aanraakbeweging aangeeft.	GestureEvent
		shiftKey : Boolean Geeft aan of de Shift-toets actief (true) of inactief (false) is.	GestureEvent
		stageX : Number [alleen-lezen] De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden in algemene werkgebiedcoördinaten.	GestureEvent
		stageY : Number [alleen-lezen] De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden in algemene werkgebiedcoördinaten.	GestureEvent
		target : Object [alleen-lezen] Doel van gebeurtenis.	Event
		type : String [alleen-lezen] Het type gebeurtenis.	Event

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		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) Maakt een Event-object met informatie over gebeurtenissen met meerdere aanraakbewegingen (zoals wanneer er tegelijkertijd met twee vingers op een touchscreen wordt gedrukt).	GestureEvent
		clone():Event [overschrijven] Maakt een kopie van het GestureEvent-object en stelt de waarde van elke eigenschap in zodat deze overeenkomt met die van het origineel.	GestureEvent
		formatToString(className:String, ... arguments):String Een hulpprogrammafunctie voor de implementatie van de methode toString() in aangepaste ActionScript 3.0-Event-klassen.	Event
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isDefaultPrevented():Boolean Controleert of de methode preventDefault() is aangeroepen voor de gebeurtenis.	Event
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		preventDefault():void Annuleert het standaardgedrag van een gebeurtenis wanneer dat gedrag kan worden geannuleerd.	Event
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		stopImmediatePropagation():void Voorkomt het verwerken van gebeurtenislisteners in het huidige knooppunt en volgende knooppunten in de gebeurtenisstroom.	Event
		stopPropagation():void Voorkomt het verwerken van gebeurtenislisteners in knooppunten die volgen op het huidige knooppunt in de gebeurtenisstroom.	Event
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toString():String [overschrijven] Retourneert een tekenreeks die alle eigenschappen van het GestureEvent-object bevat.	GestureEvent
		updateAfterEvent():void Ververst de Flash-runtimeweergave na het verwerken van de bewegingsgebeurtenis, als de weergavelijst door de gebeurtenisbeheerder is aangepast.	GestureEvent
		valueOf():Object Retourneert de primitieve waarde van het opgegeven object.	Object

Openbare constanten

Overerfde openbare constanten verbergen

Overerfde openbare constanten weergeven

	Constante		Gedefinieerd door
		GESTURE_TWO_FINGER_TAP : String = "gestureTwoFingerTap" [statisch] Definieert de waarde van de eigenschap type van een GESTURE_TWO_FINGER_TAP-bewegingsgebeurtenisobject.	GestureEvent

Eigenschapdetails

altKey

eigenschap

altKey:Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2

Geeft aan of de Alt-toets actief (true) of inactief (false) is. Alleen ondersteund voor Windows- en Linux-besturingssystemen.

Implementatie
public function get altKey():Boolean
public function set altKey(value:Boolean):void

commandKey

eigenschap

commandKey:Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 2

Geeft aan of de Command-toets is geactiveerd (alleen Macintosh).

Onder Mac OS is de waarde van de eigenschap commandKey dezelfde als die voor de eigenschap ctrlKey. Deze eigenschap is altijd false op Windows of Linux.

Implementatie
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void

controlKey

eigenschap

controlKey:Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2

Hiermee wordt aangegeven of de Control-toets actief is op de Mac en of de Ctrl-toets actief is voor Windows of Linux.

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

ctrlKey

eigenschap

ctrlKey:Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2

In Windows of Linux wordt hiermee aangegeven of de Ctrl-toets actief (true) of inactief (false) is. Op de Macintosh wordt aangegeven of de Control- of Command-toets is geactiveerd.

Implementatie
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void

localX

eigenschap

localX:Number

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden ten opzichte van de omvattende sprite.

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

localY

eigenschap

localY:Number

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden ten opzichte van de omvattende sprite.

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

phase

eigenschap

phase:String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

Een waarde van de klasse GesturePhase die de voortgang van de aanraakbeweging aangeeft. Voor de meeste bewegingen is de waarde begin, update of end. Voor gebeurtenissen voor vegen en voor tikken met twee vingers is de fasewaarde altijd all als de gebeurtenis is verzonden. Hiermee bepaalt u wanneer een gebeurtenishandler reageert op een complexe gebruikersinteractie of wanneer een handler op een aantal verschillende manieren reageert, afhankelijk van de actieve fase van een meervoudige aanraakbeweging (zoals vergroten, verplaatsen en 'loslaten' wanneer een gebruiker een visueel object op het scherm aanraakt en versleept).

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

Verwante API-elementen

flash.events.GesturePhase

shiftKey

eigenschap

shiftKey:Boolean

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2

Geeft aan of de Shift-toets actief (true) of inactief (false) is.

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

stageX

eigenschap

stageX:Number [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden in algemene werkgebiedcoördinaten. Deze eigenschap wordt berekend wanneer de eigenschap localX is ingesteld.

Implementatie
public function get stageX():Number

stageY

eigenschap

stageY:Number [alleen-lezen]

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden in algemene werkgebiedcoördinaten. Deze eigenschap wordt berekend wanneer de eigenschap localY is ingesteld.

Implementatie
public function get stageY():Number

Constructordetails

()

Constructor

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)

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

Maakt een Event-object met informatie over gebeurtenissen met meerdere aanraakbewegingen (zoals wanneer er tegelijkertijd met twee vingers op een touchscreen wordt gedrukt). Gebeurtenisobjecten worden als parameters aan gebeurtenislisteners doorgegeven.

Parameters

	`type:String` — Het type gebeurtenis. De ondersteunde waarde is: `GestureEvent.GESTURE_TWO_FINGER_TAP`.

	`bubbles:Boolean` (default = `true`) — Bepaalt of het Event-object deelneemt aan de terugkoppelfase van de gebeurtenisstroom.

	`cancelable:Boolean` (default = `false`) — Bepaalt of het Event-object kan worden geannuleerd.

	`phase:String` (default = `null`) — Een waarde van de GesturePhase-klasse die de voortgang van de aanraakbeweging aangeeft (begin, update, einde of alles).

	`localX:Number` (default = `0`) — De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden ten opzichte van de omvattende sprite.

	`localY:Number` (default = `0`) — De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden ten opzichte van de omvattende sprite.

	`ctrlKey:Boolean` (default = `false`) — In Windows of Linux wordt aangegeven of de Ctrl-toets is geactiveerd. Op de Macintosh wordt aangegeven of de Ctrl- of Command-toets is geactiveerd.

	`altKey:Boolean` (default = `false`) — Geeft aan of de Alt-toets is geactiveerd (alleen Windows of Linux).

	`shiftKey:Boolean` (default = `false`) — Geeft aan of de Shift-toets is geactiveerd.

	`commandKey:Boolean` (default = `false`) — (Alleen AIR) Geeft aan of de Command-toets is geactiveerd (alleen Macintosh). Deze parameter is alleen voor Adobe AIR; stel deze niet in voor Flash Player-content.

	`controlKey:Boolean` (default = `false`) — (Alleen AIR) Geeft aan of de Control- of Ctrl-toets is geactiveerd. Deze parameter is alleen voor Adobe AIR; stel deze niet in voor Flash Player-content.

Verwante API-elementen

flash.events.GesturePhase

Methodedetails

clone

()

methode

override public function clone():Event

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

Maakt een kopie van het GestureEvent-object en stelt de waarde van elke eigenschap in zodat deze overeenkomt met die van het origineel.

Geretourneerde waarde

Event — Een nieuw GestureEvent-object met de eigenschapswaarden die overeenkomen met het origineel.

toString

()

methode

override public function toString():String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

Retourneert een tekenreeks die alle eigenschappen van het GestureEvent-object bevat. De tekenreeks heeft de volgende indeling:

[GestureEvent type=waarde bubbles=waarde cancelable=waarde ... ]

Geretourneerde waarde

String — Een tekenreeks die alle eigenschappen van het GestureEvent-object bevat.

updateAfterEvent

()

methode

public function updateAfterEvent():void

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

Ververst de Flash-runtimeweergave na het verwerken van de bewegingsgebeurtenis, als de weergavelijst door de gebeurtenisbeheerder is aangepast.

Constantedetails

GESTURE_TWO_FINGER_TAP

Constante

public static const GESTURE_TWO_FINGER_TAP:String = "gestureTwoFingerTap"

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 10.1, AIR 2, Flash Lite 4

Definieert de waarde van de eigenschap type van een GESTURE_TWO_FINGER_TAP-bewegingsgebeurtenisobject.

Het GestureEvent-object heeft de volgende eigenschappen:

Eigenschap	Waarde
`altKey`	`true` als de Alt-toets actief is (Windows of Linux).
`bubbles`	`true`
`cancelable`	`false`; er is geen standaardgedrag om te annuleren.
`commandKey`	(alleen AIR) `true` op de Macintosh als de Command-toets actief is; `false` als deze inactief is. Altijd `false` onder Windows.
`controlKey`	`true` wanneer de Ctrl- of Control-toets actief is of `false` wanneer deze inactief is.
`ctrlKey`	`true` onder Windows of Linux als de Ctrl-toets actief is. `true` op de Macintosh als de Ctrl-toets of Command-toets actief is. Anders is deze `false`.
`currentTarget`	Het object dat het gebeurtenisobject actief verwerkt met een gebeurtenislistener.
`phase`	De huidige fase in de gebeurtenisstroom. Voor gebeurtenissen voor tikken met twee vingers is deze waarde altijd `all` overeenkomstig de waarde `GesturePhase.ALL` als de gebeurtenis is verzonden.
`isRelatedObjectInaccessible`	`true` als de eigenschap relatedObject is ingesteld op `null` wegens beveiligingsregels van de sandbox.
`localX`	De horizontale coördinaat waar de gebeurtenis heeft plaatsgevonden ten opzichte van de omvattende sprite.
`localY`	De verticale coördinaat waar de gebeurtenis heeft plaatsgevonden ten opzichte van de omvattende sprite.
`shiftKey`	`true` wanneer de Shift-toets actief is of `false` wanneer deze inactief is.
`target`	De instantie InteractiveObject onder het aanraakapparaat. Het `target` is niet altijd het object in het weergaveoverzicht dat in de gebeurtenislistener is geregistreerd. Gebruik de eigenschap `currentTarget` voor toegang tot het object in het weergaveoverzicht dat momenteel de gebeurtenis verwerkt.

Verwante API-elementen

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

Voorbeelden Hoe dit voorbeeld te gebruiken

GestureTwoFingerTap.as

In het volgende voorbeeld wordt gebeurtenishandling voor de GESTURE_TWO_FINGER_TAP-gebeurtenis weergegeven. Als de gebruiker met twee vingers tikt, roteert mySprite en wordt myTextField gevuld met de fase all. Dit is de enige fase voor gebeurtenissen voor tikken met twee vingers. Andere bewegingen van de klasse TransformGestureEvent ondersteunen de fasen begin, update en end.

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"

}

Juridische kennisgeving | Online privacybeleid

GestureEvent - AS3

Pakkettenx

Taalelementen

Bijlagen

Pakket flash.events

altKey

commandKey

controlKey

ctrlKey

localX

localY

phase

shiftKey

stageX

stageY

GestureEvent

clone

toString

updateAfterEvent

GESTURE_TWO_FINGER_TAP