GestureEvent

パッケージ	flash.events
クラス	public class GestureEvent
継承	GestureEvent Event Object
サブクラス	PressAndTapGestureEvent, TransformGestureEvent

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

GestureEvent クラスを使用すると、ユーザーの複雑な接触動作（タッチスクリーン上を 2 本の指で同時に押すなど）を検出したデバイス上で、マルチタッチイベントを処理できます。タッチスクリーン搭載の携帯電話またはタブレットなどのデバイスを操作する場合、ユーザーは通常、指やポインティングデバイスで画面に触れたり画面上で動かしたりします。GestureEvent および TransformGestureEvent クラスを使用すると、このようなユーザー操作に応答するアプリケーションを開発できます。このクラスまたは関連する TouchEvent クラスや TransformGestureEvent クラスで定義されたイベントタイプを使用して、イベントリスナーを作成します。また、これらのクラスのプロパティとメソッドを使用して、ユーザーがデバイスに接触すると応答するイベントハンドラーを作成します。

Multitouch クラスを使用して、現在の環境でタッチ操作がサポートされているかどうかを確認します。サポートされている場合は、タッチ操作のサポートを管理します。

注意：表示リスト上でオブジェクトがネストされている場合、タッチイベントは、表示リストに表示されているネストされたオブジェクトの中で、最下層のオブジェクトを対象にします。このオブジェクトはターゲットノードと呼ばれます。ターゲットノードの祖先（表示リストにターゲットノードを含むオブジェクト）がタッチイベントの通知を受け取るようにするには、祖先ノードで EventDispatcher.addEventListener() を使用する際、検出する特定のタッチイベントを type パラメーターに設定します。

例を表示

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

	プロパティ		定義元
		altKey : Boolean Alt キーがアクティブになっているか（true）非アクティブになっているか（false）を示します。	GestureEvent
		bubbles : Boolean [読み取り専用] イベントがバブリングイベントかどうかを示します。	Event
		cancelable : Boolean [読み取り専用] イベントに関連付けられた動作を回避できるかどうかを示します。	Event
		commandKey : Boolean command キーがアクティブになっているかどうかを示します（Macintosh のみ）。	GestureEvent
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。	Object
		controlKey : Boolean Mac で Control キーがアクティブになっているか、および Windows や Linux で Ctrl キーがアクティブになっているかどうかを示します。	GestureEvent
		ctrlKey : Boolean Windows または Linux で、Ctrl キーがアクティブ（true）か非アクティブ（false）かを示します。	GestureEvent
		currentTarget : Object [読み取り専用] イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。	Event
		eventPhase : uint [読み取り専用] イベントフローの現在の段階です。	Event
		localX : Number スプライトを基準とするイベント発生位置の水平座標です。	GestureEvent
		localY : Number スプライトを基準とするイベント発生位置の垂直座標です。	GestureEvent
		phase : String GesturePhase クラスから取得される値で、タッチジェスチャの進行状況を示します。	GestureEvent
		shiftKey : Boolean Shift キーがアクティブになっているか（true）非アクティブになっているか（false）を示します。	GestureEvent
		stageX : Number [読み取り専用] グローバルステージ座標を基準とするイベント発生位置の水平座標です。	GestureEvent
		stageY : Number [読み取り専用] グローバルステージ座標を基準とするイベント発生位置の垂直座標です。	GestureEvent
		target : Object [読み取り専用] イベントターゲットです。	Event
		type : String [読み取り専用] イベントのタイプです。	Event

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		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) マルチタッチイベント（タッチスクリーンを 2 本指で同時に押すなど）に関する情報を含むイベントオブジェクトを作成します。	GestureEvent
		clone():Event [オーバーライド] GestureEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。	GestureEvent
		formatToString(className:String, ... arguments):String カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。	Event
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isDefaultPrevented():Boolean イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。	Event
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		preventDefault():void イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。	Event
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		stopImmediatePropagation():void イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。	Event
		stopPropagation():void イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。	Event
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String [オーバーライド] GestureEvent オブジェクトのすべてのプロパティを含むストリングを返します。	GestureEvent
		updateAfterEvent():void イベントハンドラーによって表示リストが変更された場合、ジェスチャイベントの処理後に Flash ランタイムの表示を更新します。	GestureEvent
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object

パブリック定数

継承されるパブリック定数を隠す

継承されるパブリック定数を表示

	定数		定義元
		GESTURE_TWO_FINGER_TAP : String = "gestureTwoFingerTap" [静的] type プロパティ（GESTURE_TWO_FINGER_TAP ジェスチャイベントオブジェクト）の値を定義します。	GestureEvent

プロパティの詳細

altKey

プロパティ

altKey:Boolean

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2

Alt キーがアクティブになっているか（true）非アクティブになっているか（false）を示します。Windows および Linux のオペレーティングシステムでのみサポートされます。

実装
public function get altKey():Boolean
public function set altKey(value:Boolean):void

commandKey

プロパティ

commandKey:Boolean

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

AIR 2

command キーがアクティブになっているかどうかを示します（Macintosh のみ）。

Mac OS では、commandKey プロパティの値は ctrlKey プロパティの値と同じです。このプロパティは、Windows または Linux では常に false です。

実装
public function get commandKey():Boolean
public function set commandKey(value:Boolean):void

controlKey

プロパティ

controlKey:Boolean

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2

Mac で Control キーがアクティブになっているか、および Windows や Linux で Ctrl キーがアクティブになっているかどうかを示します。

実装
public function get controlKey():Boolean
public function set controlKey(value:Boolean):void

ctrlKey

プロパティ

ctrlKey:Boolean

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2

Windows または Linux で、Ctrl キーがアクティブ（true）か非アクティブ（false）かを示します。Macintosh では、Control キーと Command キーのいずれがアクティブになっているかどうかを示します。

実装
public function get ctrlKey():Boolean
public function set ctrlKey(value:Boolean):void

localX

プロパティ

localX:Number

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

スプライトを基準とするイベント発生位置の水平座標です。

実装
public function get localX():Number
public function set localX(value:Number):void

localY

プロパティ

localY:Number

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

スプライトを基準とするイベント発生位置の垂直座標です。

実装
public function get localY():Number
public function set localY(value:Number):void

phase

プロパティ

phase:String

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

GesturePhase クラスから取得される値で、タッチジェスチャの進行状況を示します。ほとんどのジェスチャの場合、値は begin、update、または end です。スワイプまたは 2 本の指によるタップジェスチャの場合、イベントが送出されると段階値は常に all です。この値を使用して、イベントハンドラーが複雑なユーザー操作に応答するタイミングや方法を判断します。応答方法は、マルチタッチジェスチャ（拡大、移動およびユーザーが表示されているオブジェクトに触れてから画面上をドラッグして「ドロップ」する操作など）の現在の段階ごとに異なります。

実装
public function get phase():String
public function set phase(value:String):void

関連する API エレメント

flash.events.GesturePhase

shiftKey

プロパティ

shiftKey:Boolean

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2

Shift キーがアクティブになっているか（true）非アクティブになっているか（false）を示します。

実装
public function get shiftKey():Boolean
public function set shiftKey(value:Boolean):void

stageX

プロパティ

stageX:Number [読み取り専用]

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

グローバルステージ座標を基準とするイベント発生位置の水平座標です。このプロパティは、localX プロパティが設定されている場合に計算されます。

実装
public function get stageX():Number

stageY

プロパティ

stageY:Number [読み取り専用]

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

グローバルステージ座標を基準とするイベント発生位置の垂直座標です。このプロパティは、localY プロパティが設定されている場合に計算されます。

実装
public function get stageY():Number

コンストラクターの詳細

()

コンストラクター

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)

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

マルチタッチイベント（タッチスクリーンを 2 本指で同時に押すなど）に関する情報を含むイベントオブジェクトを作成します。イベントリスナーには Event オブジェクトがパラメーターとして渡されます。

パラメーター

	`type:String` — イベントのタイプです。サポートされている値は `GestureEvent.GESTURE_TWO_FINGER_TAP` です。

	`bubbles:Boolean` (default = `true`) — Event オブジェクトがイベントフローのバブリング段階で処理されるかどうかを判断します。

	`cancelable:Boolean` (default = `false`) — Event オブジェクトがキャンセル可能かどうかを判断します。

	`phase:String` (default = `null`) — GesturePhase クラスから取得される値で、タッチジェスチャの進行状況（begin、update、end または all）を示します。

	`localX:Number` (default = `0`) — スプライトを基準とするイベント発生位置の水平座標です。

	`localY:Number` (default = `0`) — スプライトを基準とするイベント発生位置の垂直座標です。

	`ctrlKey:Boolean` (default = `false`) — Windows または Linux では、Ctrl キーがアクティブになっているかどうかを示します。Macintosh では、Ctrl キーと Command キーのいずれがアクティブになっているかどうかを示します。

	`altKey:Boolean` (default = `false`) — Alt キーがアクティブになっているかどうかを示します（Windows または Linux のみ）。

	`shiftKey:Boolean` (default = `false`) — Shift キーがアクティブになっているかどうかを示します。

	`commandKey:Boolean` (default = `false`) — （AIR のみ）Command キーがアクティブになっているかどうかを示します（Macintosh のみ）。このパラメーターは Adobe AIR 専用です。Flash Player コンテンツに対しては設定しないでください。

	`controlKey:Boolean` (default = `false`) — （AIR のみ）Control キーまたは Ctrl キーがアクティブになっているかどうかを示します。このパラメーターは Adobe AIR 専用です。Flash Player コンテンツに対しては設定しないでください。

関連する API エレメント

flash.events.GesturePhase

メソッドの詳細

clone

()

メソッド

override public function clone():Event

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

GestureEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。

戻り値

Event — 元のオブジェクトと同じプロパティ値を含む新しい GestureEvent オブジェクトです。

toString

()

メソッド

override public function toString():String

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

GestureEvent オブジェクトのすべてのプロパティを含むストリングを返します。ストリングは次の形式です。

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

戻り値

String — GestureEvent オブジェクトのすべてのプロパティを含むストリングです。

updateAfterEvent

()

メソッド

public function updateAfterEvent():void

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

イベントハンドラーによって表示リストが変更された場合、ジェスチャイベントの処理後に Flash ランタイムの表示を更新します。

定数の詳細

GESTURE_TWO_FINGER_TAP

定数

public static const GESTURE_TWO_FINGER_TAP:String = "gestureTwoFingerTap"

言語バージョン:

ActionScript 3.0

ランタイムバージョン:

Flash Player 10.1, AIR 2, Flash Lite 4

type プロパティ（GESTURE_TWO_FINGER_TAP ジェスチャイベントオブジェクト）の値を定義します。

GestureEvent オブジェクトには次のプロパティがあります。

プロパティ	値
`altKey`	Alt キーがアクティブになっている場合は `true`（Windows または Linux）。
`bubbles`	`true`
`cancelable`	`false` は、キャンセルするデフォルトの動作がないことを示します。
`commandKey`	（AIR のみ）Macintosh で Command キーがアクティブになっている場合は `true`、非アクティブになっている場合は `false` です。 Windows では常に `false` になります。
`controlKey`	Ctrl キーまたは Control キーがアクティブになっている場合は `true`、非アクティブになっている場合は `false` です。
`ctrlKey`	Windows または Linux では Ctrl キーがアクティブになっている場合は、`true` です。Macintosh では Ctrl キーまたは Command キーがアクティブになっている場合は、`true` です。それ以外の場合は `false` です。
`currentTarget`	イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
`phase`	イベントフローの現在の段階です。2 本の指によるタップイベントの場合、イベントが送出されると、この値は常に `all` になり、これは値 `GesturePhase.ALL` に対応しています。
`isRelatedObjectInaccessible`	セキュリティサンドボックスのルールによって、relatedObject プロパティが `null` に設定されている場合は `true` になります。
`localX`	スプライトを基準とするイベント発生位置の水平座標です。
`localY`	スプライトを基準とするイベント発生位置の垂直座標です。
`shiftKey`	Shift キーがアクティブになっている場合は `true`、非アクティブになっている場合は `false` です。
`target`	タッチデバイスの下にある InteractiveObject インスタンスです。`target` は、必ずしもイベントリスナーを登録した表示リスト内のオブジェクトとは限りません。現在イベントを処理している表示リスト内のオブジェクトにアクセスするには、`currentTarget` プロパティを使用します。

例この例の使用方法

GestureTwoFingerTap.as

次の例は、GESTURE_TWO_FINGER_TAP イベントのイベント処理を示しています。ユーザーがタッチ対応デバイスで 2 本指タップジェスチャを実行しているときに、mySprite が回転し、myTextField に all という段階が設定されます。2 本指タップイベントにはこの段階しかありません。TransformGestureEvent クラスのその他のジェスチャは、開始、更新および終了の各段階をサポートしています。

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"

}

法律上の注意 | プライバシーポリシー

GestureEvent - AS3

クラス x

altKey

commandKey

controlKey

ctrlKey

localX

localY

phase

shiftKey

stageX

stageY

GestureEvent

clone

toString

updateAfterEvent

GESTURE_TWO_FINGER_TAP