ActionScript® 3.0 Reference for the Adobe® Flash® Platform
Home  |  Show Packages and Classes List |  Packages  |  Classes  |  What's New  |  Index  |  Appendixes
flash.events 

GesturePhase  - AS3

Packageflash.events
Classpublic final class GesturePhase
InheritanceGesturePhase Inheritance Object

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 10.1, AIR 2, Flash Lite 4

The GesturePhase class is an enumeration class of constant values for use with the GestureEvent, PressAndTapGestureEvent, and TransformGestureEvent classes. Use these values to track the beginning, progress, and end of a touch gesture (such as moving several fingers across a touch enabled screen) so your application can respond to individual stages of user contact. Some gestures (swipe and two-finger tap gestures) do not have multiple phases, and set the event object phase property to all.

View the examples

Related API Elements



Public Properties
 PropertyDefined By
 Inheritedconstructor : Object
A reference to the class object or constructor function for a given object instance.
Object
Public Methods
 MethodDefined By
 Inherited
Indicates whether an object has a specified property defined.
Object
 Inherited
Indicates whether an instance of the Object class is in the prototype chain of the object specified as the parameter.
Object
 Inherited
Indicates whether the specified property exists and is enumerable.
Object
 Inherited
Sets the availability of a dynamic property for loop operations.
Object
 Inherited
Returns the string representation of this object, formatted according to locale-specific conventions.
Object
 Inherited
Returns the string representation of the specified object.
Object
 Inherited
Returns the primitive value of the specified object.
Object
Public Constants
 ConstantDefined By
  ALL : String = "all"
[static] A single value that encompasses all phases of simple gestures like two-finger-tap or swipe.
GesturePhase
  BEGIN : String = "begin"
[static] The beginning of a new gesture (such as touching a finger to a touch enabled screen).
GesturePhase
  END : String = "end"
[static] The completion of a gesture (such as lifting a finger off a touch enabled screen).
GesturePhase
  UPDATE : String = "update"
[static] The progress of a gesture (such as moving a finger across a touch enabled screen).
GesturePhase
Constant Detail

ALL

Constant
public static const ALL:String = "all"

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 10.1, AIR 2

A single value that encompasses all phases of simple gestures like two-finger-tap or swipe. For gestures that set the event object phase property to all (swipe and two-finger tap gestures), the phase value is always all once the event is dispatched.

Related API Elements

BEGIN

Constant 
public static const BEGIN:String = "begin"

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 10.1, AIR 2, Flash Lite 4

The beginning of a new gesture (such as touching a finger to a touch enabled screen).

Related API Elements

END

Constant 
public static const END:String = "end"

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 10.1, AIR 2, Flash Lite 4

The completion of a gesture (such as lifting a finger off a touch enabled screen).

Related API Elements

UPDATE

Constant 
public static const UPDATE:String = "update"

Language Version: ActionScript 3.0
Runtime Versions: Flash Player 10.1, AIR 2, Flash Lite 4

The progress of a gesture (such as moving a finger across a touch enabled screen).

Related API Elements

TransformGestureEventExample.as

The following example shows event handling for the GESTURE_ROTATE events. While the user performs a rotation gesture on the touch-enabled device, mySprite rotates and myTextField populates with the current phase.
Multitouch.inputMode = MultitouchInputMode.GESTURE;

var mySprite = new Sprite();
mySprite.addEventListener(TransformGestureEvent.GESTURE_ROTATE , onRotate );
mySprite.graphics.beginFill(0x336699);
mySprite.graphics.drawRect(0, 0, 100, 80);
var myTextField = new TextField();
myTextField.y = 200;
addChild(mySprite);
addChild(myTextField);

function onRotate(evt:TransformGestureEvent):void {

    evt.target.rotation -= 45;

    if (evt.phase==GesturePhase.BEGIN) {
        myTextField.text = "Begin";
    }
    if (evt.phase==GesturePhase.UPDATE) {
        myTextField.text = "Update";
    }
    if (evt.phase==GesturePhase.END) {
        myTextField.text = "End";
    }
}