Adobe® Flash® Platform 用 ActionScript® 3.0 リファレンスガイド
ホーム  |  パッケージおよびクラスリストの非表示 |  パッケージ  |  クラス  |  新機能  |  索引  |  付録  |  英語で表示される理由
フィルター: AIR 30.0 以前, Flash Player 30.0 以前, Flash Lite 4
Flex 4.6 以前, Flash Pro CS6 以前
フィルターを非表示
flash.events 

GestureEvent  - AS3

パッケージflash.events
クラスpublic class GestureEvent
継承GestureEvent Inheritance Event Inheritance 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 パラメーターに設定します。

例を表示

関連する API エレメント



パブリックプロパティ
 プロパティ定義元
  altKey : Boolean
Alt キーがアクティブになっているか(true)非アクティブになっているか(false)を示します。
GestureEvent
 Inheritedbubbles : Boolean
[読み取り専用] イベントがバブリングイベントかどうかを示します。
Event
 Inheritedcancelable : Boolean
[読み取り専用] イベントに関連付けられた動作を回避できるかどうかを示します。
Event
      commandKey : Boolean
command キーがアクティブになっているかどうかを示します(Macintosh のみ)。
GestureEvent
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。
Object
  controlKey : Boolean
Mac で Control キーがアクティブになっているか、および Windows や Linux で Ctrl キーがアクティブになっているかどうかを示します。
GestureEvent
  ctrlKey : Boolean
Windows または Linux で、Ctrl キーがアクティブ(true)か非アクティブ(false)かを示します。
GestureEvent
 InheritedcurrentTarget : Object
[読み取り専用] イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。
Event
 InheritedeventPhase : uint
[読み取り専用] イベントフローの現在の段階です。
Event
  localX : Number
スプライトを基準とするイベント発生位置の水平座標です。
GestureEvent
  localY : Number
スプライトを基準とするイベント発生位置の垂直座標です。
GestureEvent
  phase : String
GesturePhase クラスから取得される値で、タッチジェスチャの進行状況を示します。
GestureEvent
  shiftKey : Boolean
Shift キーがアクティブになっているか(true)非アクティブになっているか(false)を示します。
GestureEvent
  stageX : Number
[読み取り専用] グローバルステージ座標を基準とするイベント発生位置の水平座標です。
GestureEvent
  stageY : Number
[読み取り専用] グローバルステージ座標を基準とするイベント発生位置の垂直座標です。
GestureEvent
 Inheritedtarget : Object
[読み取り専用] イベントターゲットです。
Event
 Inheritedtype : 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
  
[オーバーライド] GestureEvent オブジェクトのコピーを作成して、各プロパティの値を元のプロパティの値と一致するように設定します。
GestureEvent
 Inherited
formatToString(className:String, ... arguments):String
カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。
Event
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。
Event
 Inherited
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。
Event
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。
Event
 Inherited
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。
Object
  
[オーバーライド] GestureEvent オブジェクトのすべてのプロパティを含むストリングを返します。
GestureEvent
  
イベントハンドラーによって表示リストが変更された場合、ジェスチャイベントの処理後に Flash ランタイムの表示を更新します。
GestureEvent
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
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 クラスから取得される値で、タッチジェスチャの進行状況を示します。ほとんどのジェスチャの場合、値は beginupdate、または end です。スワイプまたは 2 本の指によるタップジェスチャの場合、イベントが送出されると段階値は常に all です。この値を使用して、イベントハンドラーが複雑なユーザー操作に応答するタイミングや方法を判断します。応答方法は、マルチタッチジェスチャ(拡大、移動およびユーザーが表示されているオブジェクトに触れてから画面上をドラッグして「ドロップ」する操作など)の現在の段階ごとに異なります。



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

関連する API エレメント

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
コンストラクターの詳細

GestureEvent

()コンストラクター
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 エレメント

メソッドの詳細

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 オブジェクトには次のプロパティがあります。

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

関連する API エレメント

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"

}




[ X ]英語で表示される理由
ActionScript 3.0 リファレンスガイドのコンテンツが英語で表示されます。

ActionScript 3.0 リファレンスガイドのすべての部分がすべての言語に翻訳されているわけではありません。言語エレメントが翻訳されていない場合、そのエレメントは英語で表示されます。例えば、ga.controls.HelpBox クラスはどの言語にも訳されていません。このため、リファレンスガイドの日本語バージョンでは、ga.controls.HelpBox クラスは英語で表示されます。