InteractiveObject  - AS3

この InteractiveObject インスタンスの現在のアクセシビリティの実装（AccessibilityImplementation）です。

関連する API エレメント

このオブジェクトに関連付けられたコンテキストメニューを指定します。

Flash Player で実行されているコンテンツでは、このプロパティは ContextMenu オブジェクトです。 AIR ランタイムでは、ContextMenu クラスは NativeMenu クラスを拡張します。ただし、Flash Player では、ContextMenu クラスのみサポートしており、NativeMenu クラスはサポートしていません。

注意：TextField オブジェクトのコンテキストメニューには、クリップボードメニューが常に含まれます。クリップボードメニューには「カット」、「コピー」、「ペースト」、「クリア」および「すべて選択」コマンドがあります。これらのコマンドを TextField オブジェクトのコンテキストメニューから削除することはできません。TextField オブジェクトでこれらのコマンドを選択（または相当するキーボード操作を実行）する際、clear、copy、cut、paste および selectAll 各イベントは生成されません。

var red_cmi:ContextMenuItem = new ContextMenuItem("red");
red_cmi.addEventListener(ContextMenuEvent.MENU_ITEM_SELECT, cmi_menuItemSelect);
 
var cm:ContextMenu = new ContextMenu();
cm.customItems.push(red_cmi);
cm.hideBuiltInItems();
 
var spr:Sprite = new Sprite();
spr.contextMenu = cm;
spr.graphics.beginFill(0x000000);
spr.graphics.drawRect(0, 0, 120, 90);
spr.graphics.endFill();
spr.x = 10;
spr.y = 10;
addChild(spr);
 
function cmi_menuItemSelect(evt:ContextMenuEvent):void {
    spr.graphics.clear();
    spr.graphics.beginFill(0xFF0000);
    spr.graphics.drawRect(0, 0, 120, 90);
    spr.graphics.endFill();
}

オブジェクトが doubleClick イベントを受け取るかどうかを指定します。デフォルト値は false です。これは、InteractiveObject インスタンスがデフォルトでは doubleClick イベントを受け取らないことを意味します。doubleClickEnabled プロパティがtrue に設定される場合、インスタンスはその境界内で doubleClick イベントを受け取ります。InteractiveObject インスタンスの mouseEnabled プロパティもtrue に設定する必要があります。この設定は、オブジェクトが doubleClick イベントを受け取るようにするには必須です。

このプロパティを設定しても、イベントは送出されません。addEventListener() メソッドの使用は、doubleClick イベントのイベントリスナーを追加する場合に必須です。

関連する API エレメント

このオブジェクトがフォーカス矩形を表示するかどうかを指定します。true、false または null の 3 つの値のいずれかを指定できます。true および false の値は、予想されるとおり、フォーカス矩形を表示するかどうかが指定されます。null 値は、このオブジェクトが Stage の stageFocusRect プロパティに従うことを示します。

このオブジェクトでマウスまたはその他のユーザー入力メッセージを受け取るかどうかを指定します。デフォルト値は true であり、これは表示リスト上の InteractiveObject インスタンスがデフォルトでマウスイベントまたはその他のユーザー入力イベントを受け取ることを意味します。mouseEnabled を false に設定すると、インスタンスでは、マウスイベント（またはキーボードイベントなど、その他のユーザー入力イベント）を一切受け取りません。表示リスト上のこのインスタンスの子は影響を受けません。表示リスト上のオブジェクトのすべての子に関する mouseEnabled 動作を変更するには、flash.display.DisplayObjectContainer.mouseChildren を使用します。

このプロパティを設定しても、イベントは送出されません。インタラクティブな機能を作成するには、addEventListener() メソッドを使用する必要があります。

関連する API エレメント

この InteractiveObject インスタンスがフォーカスを受け取ったときに、仮想キーボード（画面上のソフトキーボード）を表示するかどうかを指定します。

デフォルトでは、この値は false で、フォーカスを受け取った InteractiveObject インスタンスはソフトキーボードを前面に表示しません。needsSoftKeyboard プロパティが true に設定されると、InteractiveObject インスタンスがユーザー入力を受け付けられる状態になったときに、ランタイムによってソフトキーボードが前面に表示されます。InteractiveObject インスタンスは、ステージの focus プロパティを設定するプログラムの呼び出し、またはタップなどのユーザーの操作の後で、ユーザー入力を受け付けられる状態になります。クライアントシステムに使用できるハードウェアキーボードがない場合、またはクライアントシステムが仮想キーボードをサポートしていない場合は、ソフトキーボードは前面に表示されません。

ソフトキーボードが前面に表示されたとき、および背後に移動したとき、InteractiveObject インスタンスは softKeyboardActivating、softKeyboardActivate および softKeyboardDeactivate イベントを送出します。

注意：このプロパティは、iOS 上の AIR アプリケーションではサポートされていません。

関連する API エレメント

ソフトキーボードの外観を制御します。

ソフトキーボードを持つデバイスでは、予想される入力の種類に合わせてキーボードのボタンをカスタマイズできます。例えば、数値の入力が予想される場合、SoftKeyboardType.NUMBER を使用して、数値のみをソフトキーボードに表示することができます。有効な値は、SoftKeyboardType クラスで定数として定義されています。

• "default"
• "punctuation"
• "url"
• "number"
• "contact"
• "email"
• "phone"
• "decimalpad"

これらの値は、現在の操作に最も適したキーボードを表示する際のヒントとして役立つヒントとして機能します。

デフォルト値： SoftKeyboardType.DEFAULT。

関連する API エレメント

ソフトキーボードが表示されたときに画面に表示したままにする領域を定義します（iOS では使用不可）。

この InteractiveObject の needsSoftKeyboard プロパティを true に設定すると、ランタイムによって、ユーザーの入力中にオブジェクトを表示したままにするために必要な調整が行われます。通常、ランタイムでは、DisplayObject.getBounds() メソッドから取得したオブジェクトの境界を使用します。この softKeyboardInputAreaOfInterest プロパティを使用すると、異なる領域を指定することができます。

softKeyboardInputAreaOfInterest をステージ座標で指定します。

注意：Android では、softKeyboardInputAreaOfInterest は横置きについては考慮されていません。

注意：softKeyboardInputAreaOfInterest は iOS ではサポートされません。

関連する API エレメント

このオブジェクトがタブ順序に含まれるかどうかを指定します。このオブジェクトがタブ順序に含まれる場合、値は true です。含まれない場合、値は false です。デフォルトでは、次の例外を除き、値は false です。

• SimpleButton オブジェクトの場合、この値は true です。
• type = "input" を持つ TextField オブジェクトの場合、値は true です。
• buttonMode = true を持つ Sprite オブジェクトまたは MovieClip オブジェクトの場合、値は true です。

SWF ファイル内のオブジェクトのタブ順序を指定します。デフォルトでは tabIndex プロパティは -1 であり、これはそのオブジェクトにタブインデックスが設定されないことを意味します。

SWF ファイルに現在表示されているオブジェクトに tabIndex プロパティがある場合は、自動タブ順序が無効になり、SWF ファイルのオブジェクトの tabIndex プロパティからタブ順序が計算されます。カスタムタブ順序には、tabIndex プロパティを持つオブジェクトのみが含まれます。

tabIndex プロパティは、通常、負以外の整数です。オブジェクトのタブ順序は、その tabIndex プロパティに従って昇順に決定されます。tabIndex の値が 1 であるオブジェクトは、tabIndex の値が 2 であるオブジェクトの前になります。複数のオブジェクトの tabIndex に同じ値を使用しないでください。

tabIndexプロパティで定義されるカスタムタブ順序は flat です。つまり、SWF ファイル内のオブジェクトの階層関係は無視されます。SWF ファイルで tabIndex プロパティを持つすべてのオブジェクトは、タブ順序に従って配置されます。タブ順序は tabIndex の値の順番に従います。

注意：TLFTextField インスタンスのタブ順序を設定するには、TLFTextField の表示オブジェクトの子を InteractiveObject としてキャストしてから、tabIndex プロパティを設定します。次に実際の使用例を示します。

	 InteractiveObject(tlfInstance.getChildAt(1)).tabIndex = 3;
	 

	 InteractiveObject(tlfInstance1.getChildAt(1)).tabIndex = 3;
	 InteractiveObject(tlfInstance2.getChildAt(1)).tabIndex = 2;
	 InteractiveObject(tlfInstance3.getChildAt(1)).tabIndex = 1;
	 

new InteractiveObject() コンストラクターを呼び出すと、ArgumentError 例外がスローされます。しかし、InteractiveObject の以下に示すサブクラスのコンストラクターを呼び出すことができます。

• new SimpleButton()
• new TextField()
• new Loader()
• new Sprite()
• new MovieClip()

仮想キーボードを前面に表示します。

このメソッドを呼び出すと、InteractiveObject インスタンスがフォーカスされ、必要に応じて、ソフトキーボードが前面に表示されます。needsSoftKeyboard が true であることも必要です。ハードウェアキーボードが使用できる場合、またはクライアントシステムが仮想キーボードをサポートしていない場合は、キーボードが前面に表示されることはありません。

注意：このメソッドは、iOS 上の AIR アプリケーションではサポートされていません。

関連する API エレメント

ユーザーがコンテキストメニューから「削除」を選択した場合に送信されます。このイベントは、現在フォーカスを持っているオブジェクトに送出されます。現在フォーカスを持っているオブジェクトが TextField である場合、このイベントのデフォルトの動作では、そのテキストフィールド内で現在選択されているテキストが削除されます。

このイベントには、次のプロパティがあります。

注意： TextField オブジェクトは、clear、copy、cut、paste、または selectAll イベントは送出しません。TextField オブジェクトのコンテキストメニューには「カット」、「コピー」、「ペースト」、「クリア」および「すべて選択」コマンドが常に含まれます。これらのコマンドを TextField オブジェクトのコンテキストメニューから削除することはできません。TextField オブジェクトでこれらのコマンドを選択（または相当するキーボード操作を実行）する際、clear、copy、cut、paste および selectAll 各イベントは生成されません。ただし、Flash テキストエンジン（FTE）を使用してビルドされたコンポーネントを含めて、InteractiveObject クラスを拡張している他のクラスは、キーボードショートカットやコンテキストメニューといったユーザーアクションへの応答としてこれらのイベントを送出します。

ユーザーが同じ InteractiveObject 上でポインティングデバイスのメインボタンを押して離すと送出されます。クリックイベントが発生するためには、mouseDown イベントに続いて mouseUp イベントが発生するという順序でなければなりません。ターゲットオブジェクトは、これらのイベントの両方について同じでなければなりません。異なる場合、click イベントは発生しません。mouseDown イベントまたは mouseUp イベントの間に他の多数のマウスイベントが発生する場合があり、click イベントは引き続き発生します。

このイベントには、次のプロパティがあります。

AIR アプリケーションでこのインタラクティブオブジェクトに関連付けられているコンテキストメニューをユーザージェスチャがトリガーすると送出されます。

このイベントには、次のプロパティがあります。

関連する API エレメント

ユーザーがコピー操作のためにプラットフォーム固有のアクセラレーターキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「コピー」を選択した場合に送出されます。このイベントは、現在フォーカスを持っているオブジェクトに送出されます。現在フォーカスを持っているオブジェクトが TextField である場合、このイベントのデフォルトの動作では、そのテキストフィールド内で現在選択されているテキストがクリップボードにコピーされます。

このイベントには、次のプロパティがあります。

注意： TextField オブジェクトは、clear、copy、cut、paste、または selectAll イベントは送出しません。TextField オブジェクトのコンテキストメニューには「カット」、「コピー」、「ペースト」、「クリア」および「すべて選択」コマンドが常に含まれます。これらのコマンドを TextField オブジェクトのコンテキストメニューから削除することはできません。TextField オブジェクトでこれらのコマンドを選択（または相当するキーボード操作を実行）する際、clear、copy、cut、paste および selectAll 各イベントは生成されません。ただし、Flash テキストエンジン（FTE）を使用してビルドされたコンポーネントを含めて、InteractiveObject クラスを拡張している他のクラスは、キーボードショートカットやコンテキストメニューといったユーザーアクションへの応答としてこれらのイベントを送出します。

ユーザーがカット操作のためにプラットフォーム固有のアクセラレーターキーの組み合わせをアクティブ化したとき、またはコンテキストメニューから「カット」を選択した場合に送出されます。このイベントは、現在フォーカスを持っているオブジェクトに送出されます。現在フォーカスを持っているオブジェクトが TextField である場合、このイベントのデフォルトの動作では、そのテキストフィールド内で現在選択されているテキストがクリップボードにカットされます。

このイベントには、次のプロパティがあります。

注意： TextField オブジェクトは、clear、copy、cut、paste、または selectAll イベントは送出しません。TextField オブジェクトのコンテキストメニューには「カット」、「コピー」、「ペースト」、「クリア」および「すべて選択」コマンドが常に含まれます。これらのコマンドを TextField オブジェクトのコンテキストメニューから削除することはできません。TextField オブジェクトでこれらのコマンドを選択（または相当するキーボード操作を実行）する際、clear、copy、cut、paste および selectAll 各イベントは生成されません。ただし、Flash テキストエンジン（FTE）を使用してビルドされたコンポーネントを含めて、InteractiveObject クラスを拡張している他のクラスは、キーボードショートカットやコンテキストメニューといったユーザーアクションへの応答としてこれらのイベントを送出します。

オブジェクトの doubleClickEnabled フラグが true に設定されている場合には、ユーザーが同じ InteractiveObject 上でポインティングデバイスのメインボタンを 2 回続けてすばやく押して離すと送出されます。doubleClick イベントが発生するためには、mouseDown、mouseUp、click、mouseDown、mouseUp の一連のイベントの直後でなければなりません。これらのすべてのイベントは、doubleClick イベントと同じターゲットを共有している必要があります。2 回目の mouseDown イベントと mouseUp イベントによって表される 2 回目のクリックは、click イベント後の特定の期間内に発生する必要があります。この期間の設定可能な長さは、オペレーティングシステムによって異なり、ほとんどの場合ユーザーが設定できます。ターゲットが選択可能なテキストフィールドである場合、デフォルトの動作ではポインターの下の語が選択されます。ターゲットの InteractiveObject の doubleClickEnabled フラグが true に設定されていない場合、2 つの click イベントを受け取ります。

doubleClickEnabled プロパティのデフォルト値は false です。

TextField オブジェクトのダブルクリックによるテキスト選択の動作は、doubleClick イベントとは無関係です。TextField.doubleClickEnabled を使用して TextField の選択を制御します。

このイベントには、次のプロパティがあります。

関連する API エレメント

表示オブジェクトがフォーカスを取得した後に送出されます。この状況は、ポインティングデバイスまたはキーボードによる操作でオブジェクトをハイライトするときに生じます。そのようなフォーカスの受け取り側はこのイベントのターゲットオブジェクトと呼ばれ、この変更によってフォーカスを失う対応する InteractiveObject インスタンスは関連オブジェクトと呼ばれます。関連オブジェクトへの参照は、受信側オブジェクトの relatedObject プロパティに格納されます。shiftKey プロパティは使用されません。このイベントは、前のオブジェクトの focusOut イベントが送出された後に発生します。

このイベントには、次のプロパティがあります。

表示オブジェクトがフォーカスを失った後に送出されます。これは、ポインティングデバイスまたはキーボードによる操作で別のオブジェクトをハイライトするときに生じます。フォーカスを失うオブジェクトはこのイベントのターゲットオブジェクトと呼ばれ、フォーカスを受け取る対応する InteractiveObject インスタンスは関連オブジェクトと呼ばれます。関連オブジェクトへの参照は、ターゲットオブジェクトの relatedObject プロパティに格納されます。shiftKey プロパティは使用されません。このイベントは、関連オブジェクトから focusIn イベントが送出される前に発生します。

このイベントには、次のプロパティがあります。

ユーザーが InteractiveObject インスタンスでタッチサーフェスの端に沿って接触点を作成したとき（例えば、Apple TV の Siri Remote でタッチサーフェスの端に沿ってタップしたときなど）に送出されます。デバイスによっては、この接触を複数のタッチイベントの組み合わせと解釈する可能性もあります。

具体的には、ユーザーが InteractiveObject 上に指を触れてから指を動かした際、InteractiveObject インスタンスから gestureDirectionalTap イベントだけでなく、touchBegin イベントおよび touchEnd イベントを送出する場合があります。また、現在の環境でサポートされていれば、対象となるすべてのイベントが送出されることもあります。ユーザー操作の処理方法を選択してください。タッチイベントの処理を管理するには、flash.ui.Multitouch クラスを使用します。タッチジェスチャのイベント処理や単純なタッチポイントのイベント処理の有効化、タッチイベントを無効化してマウスイベントだけが送出されるようにするなどの処理が可能です。touchBegin イベントを処理するように選択すると、タッチ対応デバイスで同じイベントハンドラーが実行されます。ただし、gestureDirectionalTap イベントを処理するように選択すると、タッチ対応環境固有の要件に合わせてイベントハンドラーを設計して、より優れたタッチ操作のユーザーエクスペリエンスを実現できます。両方のイベントを個別に処理することもできます。これにより、ジェスチャイベントとタッチイベントにそれぞれ異なる応答を返すことができます。しかし、flash.ui.Multitouch クラスでは、タッチイベントとジェスチャイベントのどちらがトリガーされるかを決定します。

イベントオブジェクトのプロパティを処理する際、localX および localY プロパティは初期接触位置（Apple TV の場合は画面の中央）に設定されます。offsetX プロパティと offsetY プロパティはジェスチャの方向に対応します。

メモ：この API では 1 本指の方向タップのみサポートしています。

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

関連する API エレメント

タッチ対応デバイスで、ユーザーが同じ InteractiveObject インスタンス上の 2 つの接触位置を押したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの表示オブジェクト上を、2 本の指で押したり離したりする場合など）。一部のデバイスでは、この接触を doubleClick イベントとして解釈する場合もあります。

具体的には、ユーザーが InteractiveObject 上を 2 本の指でタップすると、InteractiveObject インスタンスから doubleClick イベントまたは gestureTwoFingerTap イベントのいずれか、または現在の環境でサポートされている場合は両方のイベントを送出することがあります。ユーザー操作の処理方法を選択してください。タッチイベントの処理を管理するには、flash.ui.Multitouch クラスを使用します。タッチジェスチャのイベント処理や単純なタッチポイントのイベント処理の有効化、タッチイベントを無効化してマウスイベントだけが送出されるようにするなどの処理が可能です。doubleClick イベントを処理するように選択すると、タッチ対応デバイスとマウス対応デバイスの両方で、同じイベントハンドラーが実行されます。ただし、gestureTwoFingerTap イベントを処理するように選択すると、タッチ対応環境固有の要件に合わせてイベントハンドラーを設計して、より優れたタッチ操作のユーザーエクスペリエンスを実現できます。両方のイベントを個別に処理することもできます。これにより、タッチイベントとマウスイベントにそれぞれ異なる応答を返すことができます。

注意：環境互換性情報については、Multitouch クラスを参照してください。

関連する API エレメント

タッチ対応デバイスで、ユーザーが InteractiveObject インスタンス上の接触位置でタッチポイントを移動したときに送出されます（例えば、タッチスクリーン搭載の携帯電話やタブレットの表示オブジェクト上で、指を左から右に動かす場合など）。一部のデバイスでは、この接触を mouseOver イベントおよび touchOver イベントとして解釈する場合もあります。

具体的には、ユーザーが InteractiveObject 上に指を動かすと、InteractiveObject インスタンスから mouseOver イベント、touchOver イベント、gesturePan イベントのいずれか、または現在の環境でサポートされている場合はすべてのイベントを送出することがあります。ユーザー操作の処理方法を選択してください。タッチイベントの処理を管理するには、flash.ui.Multitouch クラスを使用します。タッチジェスチャのイベント処理や単純なタッチポイントのイベント処理の有効化、タッチイベントを無効化してマウスイベントだけが送出されるようにするなどの処理が可能です。mouseOver イベントを処理するように選択すると、タッチ対応デバイスとマウス対応デバイスの両方で、同じイベントハンドラーが実行されます。ただし、gesturePan イベントを処理するように選択すると、タッチ対応環境固有の要件に合わせてイベントハンドラーを設計して、より優れたタッチ操作のユーザーエクスペリエンスを実現できます。両方のイベントを個別に処理することもできます。これにより、タッチイベントとマウスイベントにそれぞれ異なる応答を返すことができます。

注意：環境互換性情報については、Multitouch クラスを参照してください。

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

Multitouch.inputMode = MultitouchInputMode.GESTURE;

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

function onPan(evt:TransformGestureEvent):void {

    evt.target.localX++;

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

関連する API エレメント

InteractiveObject インスタンスとの接触位置で、ユーザーが回転ジェスチャを実行したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの画面に 2 本指で触れ、その指を表示オブジェクト上で回転させる場合など）。2 本の指による回転は、共通の回転ジェスチャですが、回転を示す要件は、デバイスやオペレーティングシステムごとに異なります。一部のデバイスでは、この接触を複数のマウスイベントの組み合わせとして解釈する場合もあります。

具体的には、ユーザーが InteractiveObject 上に指を動かすと、InteractiveObject インスタンスから gestureRotate イベントの他に、mouseOver イベントおよび click イベントを送出する場合があります。また、現在の環境でサポートされている場合、対象となるすべてのイベントが送出されることもあります。ユーザー操作の処理方法を選択してください。タッチイベントの処理を管理するには、flash.ui.Multitouch クラスを使用します。タッチジェスチャのイベント処理や単純なタッチポイントのイベント処理の有効化、タッチイベントを無効化してマウスイベントだけが送出されるようにするなどの処理が可能です。mouseOver イベントを処理するように選択すると、タッチ対応デバイスとマウス対応デバイスの両方で、同じイベントハンドラーが実行されます。ただし、gestureRotate イベントを処理するように選択すると、タッチ対応環境固有の要件に合わせてイベントハンドラーを設計して、より優れたタッチ操作のユーザーエクスペリエンスを実現できます。両方のイベントを個別に処理することもできます。これにより、タッチイベントとマウスイベントにそれぞれ異なる応答を返すことができます。

イベントオブジェクトのプロパティを処理する際、localX および localY プロパティは初期接触位置に設定されます。offsetX および offsetY プロパティは、回転ジェスチャの終点となる接触位置への距離です。

注意：環境互換性情報については、Multitouch クラスを参照してください。

このイベントの発生中、rotation プロパティには回転角度が含まれます。回転の値は次のとおりです。

• 時計回りの場合は 0 ～ 180 度
• 反時計回りの場合は - 180 ～ 0 度

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

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

関連する API エレメント

InteractiveObject インスタンスとの接触位置で、ユーザーがスワイプジェスチャを実行したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの画面に 3 本指で触れてから、表示オブジェクト上でその 3 本の指をそろえて動かした場合など）。指をそろえて動かす動作は共通のスワイプジェスチャですが、スワイプの要件はデバイスやオペレーティングシステムによって異なります。一部のデバイスでは、この接触を複数のマウスイベントの組み合わせとして解釈する場合もあります。

具体的には、ユーザーが InteractiveObject 上に指を置いてから指を動かした際、InteractiveObject インスタンスから gestureSwipe イベントの他に、rollOver イベントおよび rollOut イベントを送出する場合があります。また、現在の環境でサポートされていれば、対象となるすべてのイベントが送出されることもあります。ユーザー操作の処理方法を選択してください。rollOver イベントを処理するように選択すると、タッチ対応デバイスとマウス対応デバイスの両方で、同じイベントハンドラーが実行されます。ただし、gestureSwipe イベントを処理するように選択すると、タッチ対応環境固有の要件に合わせてイベントハンドラーを設計して、より優れたタッチ操作のユーザーエクスペリエンスを実現できます。両方のイベントを個別に処理することもできます。これにより、タッチイベントとマウスイベントにそれぞれ異なる応答を返すことができます。

イベントオブジェクトのプロパティを処理する際、localX および localY プロパティは初期接触位置に設定されます。offsetX および offsetY プロパティは、スワイプジェスチャの終点となる接触位置までの距離を表します。

注意：Mac OS オペレーティ グシステムを採用しているデバイスの中には 4 本指のスワイプを解釈できるものがありますが、この API でサポートされるのは、3 本指のスワイプのみです。

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

Multitouch.inputMode = MultitouchInputMode.GESTURE;

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

function onSwipe(evt:TransformGestureEvent):void {

    if (evt.offsetX == 1 ) {
    myTextField.text = "right";
    }
    if (evt.offsetY == -1) {
    myTextField.text = "up";
    }
    myTextField.text = evt.phase;

}

関連する API エレメント

タッチ対応デバイス上で、ユーザーが InteractiveObject インスタンスとの接触位置を形成してからタップしたときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの画面で、表示オブジェクト上に複数の指を置いてメニューを開いてから、1 本の指でタップしてメニューアイテムを選択する場合など）。一部のデバイスでは、この接触を複数のマウスイベントの組み合わせとして解釈する場合もあります。

具体的には、ユーザーが InteractiveObject 上に指を動かしてからもう一度タップした場合、InteractiveObject インスタンスから gesturePressAndTap イベントの他に、mouseOver イベントおよび click イベントを送出する場合があります。また、現在の環境でサポートされている場合、対象となるすべてのイベントが送出されることもあります。ユーザー操作の処理方法を選択してください。タッチイベントの処理を管理するには、flash.ui.Multitouch クラスを使用します。タッチジェスチャのイベント処理や単純なタッチポイントのイベント処理の有効化、タッチイベントを無効化してマウスイベントだけが送出されるようにするなどの処理が可能です。mouseOver イベントを処理するように選択すると、タッチ対応デバイスとマウス対応デバイスの両方で、同じイベントハンドラーが実行されます。ただし、gesturePressAndTap イベントを処理するように選択すると、タッチ対応環境固有の要件に合わせてイベントハンドラーを設計して、より優れたタッチ操作のユーザーエクスペリエンスを実現できます。両方のイベントを個別に処理することもできます。これにより、タッチイベントとマウスイベントにそれぞれ異なる応答を返すことができます。

イベントオブジェクトのプロパティを処理する際、localX および localY プロパティは初期接触位置（「プッシュ」）に設定されます。offsetX および offsetY プロパティは、2 番目の接触位置（「タップ」）への距離です。

関連する API エレメント

InteractiveObject インスタンスとの接触位置で、ユーザーがズームジェスチャを実行したときに送出されます（例えば、タッチスクリーン搭載の携帯電話またはタブレットの画面に 2 本指で触れてから、表示オブジェクト上でその 2 本の指をすばやく広げた場合など）。指を広げる動作は共通のズームジェスチャですが、ズームを示す要件は、デバイスやオペレーティングシステムごとに異なります。一部のデバイスでは、この接触を複数のマウスイベントの組み合わせとして解釈する場合もあります。

具体的には、ユーザーが InteractiveObject 上に指を動かしてから 2 本の指を広げた際、InteractiveObject インスタンスから gestureZoom イベントの他に、mouseOver イベントおよび click イベントを送出する場合があります。また、現在の環境でサポートされている場合、対象となるすべてのイベントが送出されることもあります。ユーザー操作の処理方法を選択してください。タッチイベントの処理を管理するには、flash.ui.Multitouch クラスを使用します。タッチジェスチャのイベント処理や単純なタッチポイントのイベント処理の有効化、タッチイベントを無効化してマウスイベントだけが送出されるようにするなどの処理が可能です。mouseOver イベントを処理するように選択すると、タッチ対応デバイスとマウス対応デバイスの両方で、同じイベントハンドラーが実行されます。ただし、gestureZoom イベントを処理するように選択すると、タッチ対応環境固有の要件に合わせてイベントハンドラーを設計して、より優れたタッチ操作のユーザーエクスペリエンスを実現できます。両方のイベントを個別に処理することもできます。これにより、タッチイベントとマウスイベントにそれぞれ異なる応答を返すことができます。

イベントオブジェクトのプロパティを処理する際、localX および localY プロパティは初期接触位置に設定されます。offsetX および offsetY プロパティは、ズームジェスチャの終点となる接触位置への距離です。

注意：環境互換性情報については、Multitouch クラスを参照してください。

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

Multitouch.inputMode = MultitouchInputMode.GESTURE;

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

function onZoom(evt:TransformGestureEvent):void {

    evt.target.scaleX++;

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

関連する API エレメント

このイベントは、IME でインライン入力をサポートしているすべてのクライアントアプリケーションに送出されます。

ユーザーがキーを押したときに送出されます。キーと特殊文字の間のマッピングはデバイスやオペレーティングシステムによって異なります。このタイプのイベントは、マッピングが発生してから、IME（入力メソッドエディター）が処理される前に生成されます。IME は、標準的な QWERTY キーボードでは十分に対応できない、中国語の漢字などの文字を入力するために使用されます。このイベントは、keyUp イベントの前に発生します。

AIR の場合、このイベントをキャンセルすると、テキストフィールドに文字が入力されなくなります。

このイベントには、次のプロパティがあります。

ユーザーがキーボード操作によってフォーカスを変更しようとすると送出されます。このイベントのデフォルトの動作では、フォーカスを変更して、対応する focusIn イベントと focusOut イベントを送出します。

このイベントは、現在フォーカスを持っているオブジェクトに送出されます。このイベントの関連オブジェクトは、デフォルトの動作を変更していない場合は、フォーカスを受け取る InteractiveObject インスタンスです。ターゲットオブジェクトに正しく登録されているイベントリスナーで preventDefault() メソッドを呼び出すことによって、フォーカスを変更不可にできます。フォーカスが変更され、デフォルトでは focusIn および focusOut イベントが送出されます。

このイベントには、次のプロパティがあります。

ユーザーがキーを離したときに送出されます。キーと特殊文字の間のマッピングはデバイスやオペレーティングシステムによって異なります。このタイプのイベントは、マッピングが発生してから、IME（入力メソッドエディター）が処理される前に生成されます。IME は、標準的な QWERTY キーボードでは十分に対応できない、中国語の漢字などの文字を入力するために使用されます。このイベントは keyDown イベントの後に発生し、次のような特性があります。

このイベントには、次のプロパティがあります。

ユーザーが同じ InteractiveObject 上でポインティングデバイスの中央ボタンを押して離すと送出されます。 middleClick イベントが発生するためには、middleMouseDown イベントに続いて middleMouseUp イベントが発生するという順序でなければなりません。 ターゲットオブジェクトは、これらのイベントの両方について同じでなければなりません。異なる場合、middleClick イベントは発生しません。 middleMouseDown イベントまたは middleMouseUp イベントの間に他の多数のマウスイベントが発生する場合があり、middleClick イベントは引き続き発生します。

このイベントには、次のプロパティがあります。

ユーザーが InteractiveObject インスタンス上でポインティングデバイスの中央ボタンを押したときに送出されます。

このイベントには、次のプロパティがあります。

ユーザーが InteractiveObject インスタンス上でポインティングデバイスのボタンを離したときに送出されます。

このイベントには、次のプロパティがあります。

ユーザーが InteractiveObject インスタンス上でポインティングデバイスのボタンを押したときに送出されます。 ターゲットが SimpleButton インスタンスである場合、デフォルトの動作では SimpleButton インスタンスは downState 表示オブジェクトを表示します。ターゲットが選択可能なテキストフィールドである場合、デフォルトの動作ではテキストフィールドの選択が開始されます。

このイベントには、次のプロパティがあります。

ユーザーがポインティングデバイスでフォーカスを変更しようとすると送出されます。このイベントのデフォルトの動作では、フォーカスを変更して、対応する focusIn イベントと focusOut イベントを送出します。

このイベントは、現在フォーカスを持っているオブジェクトに送出されます。このイベントの関連オブジェクトは、デフォルトの動作を変更していない場合は、フォーカスを受け取る InteractiveObject インスタンスです。ターゲットオブジェクトに正しく登録されているイベントリスナーで preventDefault() を呼び出すことによって、フォーカスを変更できないようにすることができます。shiftKey プロパティは使用されません。フォーカスが変更され、デフォルトでは focusIn および focusOut イベントが送出されます。

このイベントには、次のプロパティがあります。

InteractiveObject の上で、ユーザーがポインティングデバイスを移動させたときに送出されます。ターゲットがユーザーの選択するテキストフィールドである場合、選択はデフォルトの動作で更新されます。

このイベントには、次のプロパティがあります。

ユーザーが InteractiveObject インスタンスからポインティングデバイスを離したときに送出されます。イベントターゲットは、直前にポインティングデバイスの下に置かれていたオブジェクトです。relatedObject はポインティングデバイスの移動先のオブジェクトです。ターゲットが SimpleButton インスタンスである場合、デフォルトの動作ではボタンは upState 表示オブジェクトを表示します。

mouseOut イベントは、表示オブジェクトコンテナの別の子オブジェクト上にマウスが残る場合でも、表示オブジェクトコンテナの子オブジェクトの領域からマウスが出るたびに送出されます。これは、rollOut イベントの目的の動作とは異なります。この動作は、子を持つ表示オブジェクトコンテナのロールオーバー動作のコーディングを単純化するためのものです。表示オブジェクトの領域か、その子の領域からマウスが出て、その表示オブジェクトの子ではないオブジェクトに進む場合、表示オブジェクトは rollOut イベントを送出します。rollOut イベントは、そのオブジェクトの親チェーンを上方向にたどり、連続して送出されます。チェーンの開始はそのオブジェクトで、終わりは relatedObject のルートでも祖先でもない最高位の親です。

このイベントには、次のプロパティがあります。

ユーザーが InteractiveObject インスタンスにポインティングデバイスを合わせたときに送出されます。relatedObject は、直前にポインティングデバイスの下に置かれていたオブジェクトです。ターゲットが SimpleButton インスタンスである場合、オブジェクトはデフォルトの動作として、マウスボタンが押されているかどうかに応じて、オブジェクトは overState または upState 表示オブジェクトを表示します。

mouseOver イベントは、表示オブジェクトコンテナの別の子オブジェクト上に既にマウスがあった場合でも、表示オブジェクトコンテナの子オブジェクトの領域にマウスが入るたびに送出されます。これは、rollOver イベントの目的の動作とは異なります。この動作は、子を持つ表示オブジェクトコンテナのロールアウト動作のコーディングを単純化するためのものです。表示オブジェクトの子ではないオブジェクトから、表示オブジェクトの領域か、その子の領域にマウスが入るとき、表示オブジェクトは rollOver イベントを送出します。rollOver イベントは、そのオブジェクトの親チェーンを relatedObject のルートでも祖先でもない最高位の親から始めて下方向にたどっていき、そのオブジェクトに至るまで連続して送出されます。

このイベントには、次のプロパティがあります。

ユーザーが InteractiveObject インスタンス上でポインティングデバイスのボタンを離したときに送出されます。 ターゲットが SimpleButton インスタンスである場合、オブジェクトは upState 表示オブジェクトを表示します。ターゲットが選択可能なテキストフィールドである場合、デフォルトの動作ではテキストフィールドの選択が終了します。

このイベントには、次のプロパティがあります。

マウスホイールが InteractiveObject インスタンス上を回転するときに送出されます。 ターゲットがテキストフィールドである場合、デフォルトの動作ではテキストはスクロールします。Microsoft Windows オペレーティングシステムでのみ使用できます。

このイベントには、次のプロパティがあります。

ユーザーがドラッグジェスチャを止めると、ドラッグイニシエータ InteractiveObject から送出されます。

イベントの dropAction プロパティは、ドラッグのターゲットオブジェクトによって設定されたアクションを示します。値 "none"（DragActions.NONE）は、ドロップ操作がキャンセルされたか、受け入れられなかったことを示します。

nativeDragComplete イベントハンドラーは、開始表示オブジェクトの状態を更新する場合に便利です。例えば、リストからアイテムを削除する場合（move のドラッグアクション）や、ビジュアルプロパティを変更する場合が該当します。

このイベントには、次のプロパティがあります。

ドラッグされたオブジェクトがターゲットにドロップされ、そのドロップ操作が DragManager.acceptDragDrop() の呼び出しで受け入れられた場合に、ターゲットの InteractiveObject から送出されます。

イベントオブジェクトの clipboard プロパティを使用して、ドロップされたデータにアクセスします。

このイベントのハンドラーでは、DragManager.dropAction プロパティを設定し、受け入れられたドラッグアクションについて、イニシエータオブジェクトにフィードバックを提供する必要があります。 値が設定されていない場合、DragManager は、許可されているアクションのリストからデフォルト値を選択します。

このイベントには、次のプロパティがあります。