Indicates whether the Alt key is active (true) or inactive (false). Supported for Windows and Linux operating systems only.

Indicates whether the command key is activated (Mac only).

On a Mac OS, the value of the commandKey property is the same value as the ctrlKey property. This property is always false on Windows or Linux.

Indicates whether the Control key is activated on Mac and whether the Ctrl key is activated on Windows or Linux.

On Windows or Linux, indicates whether the Ctrl key is active (true) or inactive (false). On Macintosh, indicates whether either the Control key or the Command key is activated.

Indicates whether the first point of contact is mapped to mouse events.

See also

If true, the relatedObject property is set to null for reasons related to security sandboxes. If the nominal value of relatedObject is a reference to a DisplayObject in another sandbox, relatedObject is set to null unless there is permission in both directions across this sandbox boundary. Permission is established by calling Security.allowDomain() from a SWF file, or by providing a policy file from the server of an image file, and setting the LoaderContext.checkPolicyFile property when loading the image.

See also

Reports that this touch input sequence was canceled by the operating system.

Touch events can be canceled for a variety of reasons, such as when a palm-generated touch is rejected because a pen stylus is in use. isTouchPointCanceled can only be true in a touchEnd event.

The horizontal coordinate at which the event occurred relative to the containing sprite.

The vertical coordinate at which the event occurred relative to the containing sprite.

A value between 0.0 and 1.0 indicating force of the contact with the device. If the device does not support detecting the pressure, the value is 1.0.

A reference to a display list object that is related to the event. For example, when a touchOut event occurs, relatedObject represents the display list object to which the pointing device now points. This property applies to the touchOut, touchOver, touchRollOut, and touchRollOver events.

The value of this property can be null in two circumstances: if there is no related object, or there is a related object, but it is in a security sandbox to which you don't have access. Use the isRelatedObjectInaccessible() property to determine which of these reasons applies.

See also

Indicates whether the Shift key is active (true) or inactive (false).

Width of the contact area.

Height of the contact area.

The horizontal coordinate at which the event occurred in global Stage coordinates. This property is calculated when the localX property is set.

The vertical coordinate at which the event occurred in global Stage coordinates. This property is calculated when the localY property is set.

Reports the time of the event in relative milliseconds.

The times reported are relative to the time the application started execution. For events that return a sequence of points in the samples buffer, this timestamp reflects the elapsed time of the last sample in the buffer.

See also

Reports whether the touch was generated by the primary or the eraser end of a stylus.

If a touch event is generated by a finger or other non-stylus input method, or a stylus for which high-frequency motion tracking is not supported, this property reports the value: TouchEventIntent.UNKNOWN.

The TouchEventIntent class defines constants for the possible values of this property, which include:

• TouchEventIntent.ERASER
• TouchEventIntent.PEN
• TouchEventIntent.UNKNOWN

See also

A unique identification number (as an int) assigned to the touch point.

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; 
}

Creates an Event object that contains information about touch events. Event objects are passed as parameters to event listeners.

Creates a copy of the TouchEvent object and sets the value of each property to match that of the original.

Updates the specified ByteArray object with the high-frequency data points for a multi-point touch event.

The ByteArray object referenced by the buffer parameter is updated with values for the intermediate data points between this and the previous touch event. Three floating point values are added for each sample: an x coordinate, a y coordinate, and a pressure value. The position values reported in stage coordinates. The pressure is reported as a value between 0 and 1. Samples are recorded at regular time intervals. The exact frequency depends on the device hardware and hardware drivers. Typical sample frequencies are around 133 Hz. Note that touch events are not dispatched at exact intervals. Thus, the buffer for similar events can contain a different number of samples. The last sample in the buffer has the same data as the stageX, stageY, and pressure properties of this touch event object.

A sample buffer is included in the event objects dispatched for proximityMove and touchMove events.

See also

import flash.events.TouchEvent;

import flash.events.TouchEvent;
import flash.events.TouchEventIntent;
import flash.utils.ByteArray;

Reports that the hardware button at the specified index is pressed.

Returns a string that contains all the properties of the TouchEvent object. The string is in the following format:

[TouchEvent type=value bubbles=value cancelable=value ... ]

Instructs Flash Player or Adobe AIR to render after processing of this event completes, if the display list has been modified.

Defines the value of the type property of a PROXIMITY_BEGIN touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a PROXIMITY_END touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a PROXIMITY_MOVE touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a PROXIMITY_OUT touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a PROXIMITY_OVER touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a PROXIMITY_ROLL_OUT touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a PROXIMITY_ROLL_OVER touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a TOUCH_BEGIN touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a TOUCH_END touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a TOUCH_MOVE touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a TOUCH_OUT touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a TOUCH_OVER touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a TOUCH_ROLL_OUT touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a TOUCH_ROLL_OVER touch event object.

The dispatched TouchEvent object has the following properties:

See also

Defines the value of the type property of a TOUCH_TAP touch event object.

The dispatched TouchEvent object has the following properties:

See also

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);
}