Event  - AS3

イベントがバブリングイベントかどうかを示します。イベントがバブル可能な場合、この値は true です。バブル不可能な場合は、false です。

イベントが発生すると、イベントフローの 3 つの段階に進みます。表示リストの一番上の階層からターゲットノードの直前までのキャプチャ段階、ターゲットノードに対応するターゲット段階、およびターゲットノードの次のノードから表示リスト階層に戻るまでのバブリング段階があります。

activate イベントや unload イベントなど一部のイベントにはバブリング段階がありません。バブリング段階のないイベントの bubbles プロパティの値は false です。

イベントに関連付けられた動作を回避できるかどうかを示します。動作がキャンセル可能な場合、この値は true です。キャンセル不可能な場合は、false です。

関連する API エレメント

イベントリスナーで Event オブジェクトをアクティブに処理しているオブジェクトです。例えば、ユーザーが「OK」をクリックした場合、currentTarget は、そのボタンまたは、そのイベントに対してイベントリスナーを登録している祖先の 1 つを含むノードになります。

イベントフローの現在の段階です。このプロパティには、次の数値が含まれます。

• キャプチャ段階（EventPhase.CAPTURING_PHASE）
• ターゲット段階（EventPhase.AT_TARGET）
• バブリング段階（EventPhase.BUBBLING_PHASE）

イベントターゲットです。このプロパティにはターゲットノードが含まれます。例えば、ユーザーが「OK」をクリックした場合、ターゲットノードはそのボタンを含む表示リストノードです。

イベントのタイプです。タイプでは大文字小文字が区別されます。

イベントリスナーにパラメーターとして渡す Event オブジェクトを作成します。

Event サブクラスのインスタンスを複製します。

Event オブジェクトの元のインスタンスのコピーである、新しい Event オブジェクトを返します。通常、clone() を呼び出さないでください。イベントを再送出すると、つまり、ハンドラーから dispatchEvent(event) を呼び出すと（このハンドラーは event を処理しているハンドラー）、EventDispatcher クラスが自動的にこのメソッドを呼び出します。

新しい Event オブジェクトには、元のオブジェクトのすべてのプロパティが含まれます。

カスタム Event クラスを作成する場合は、カスタムクラスのプロパティが複製されるように、継承された Event.clone() メソッドをオーバーライドする必要があります。イベントサブクラスに追加するすべてのプロパティを設定しなかった場合、再送出されたイベントをリスナーが処理するときに、プロパティに正しい値が含まれません。

この例では、PingEvent は Event のサブクラスであるため、独自のバージョンの clone() を実装します。

     class PingEvent extends Event {
         var URL:String;
         
     public override function clone():Event {
              return new PingEvent(type, bubbles, cancelable, URL);
        }
     }
     

カスタム ActionScript 3.0 Event クラスに toString() メソッドを実装するためのユーティリティ関数です。toString() メソッドをオーバーライドすることは、推奨されますが必須ではありません。

	 class PingEvent extends Event {
	  var URL:String;
	 
	 public override function toString():String { 
	  return formatToString("PingEvent", "type", "bubbles", "cancelable", "eventPhase", "URL"); 
	    }
	 }
	 

パラメーター

イベントで preventDefault() メソッドが呼び出されたかどうかを確認します。preventDefault() メソッドが呼び出された場合は true、それ以外の場合は false を返します。

関連する API エレメント

イベントのデフォルト動作をキャンセルできる場合に、その動作をキャンセルします。

多くのイベントには、デフォルトで実行される動作が関連付けられています。例えば、ユーザーがテキストフィールドに文字を入力した場合、デフォルト動作では文字がテキストフィールドに表示されます。TextEvent.TEXT_INPUT イベントのデフォルト動作はキャンセルできるので、preventDefault() メソッドを使用して文字を表示しないようにすることができます。

キャンセルできない動作の例としては、Event.REMOVED イベントに関連付けられているデフォルト動作があります。このイベントは、Flash Player が表示リストから表示オブジェクトを削除しようとすると生成されます。このデフォルト動作（要素の削除）はキャンセルできません。つまり、preventDefault() メソッドを呼び出してもこのデフォルト動作には効果がありません。

Event.cancelable プロパティを使用して、特定のイベントに関連付けられているデフォルト動作をキャンセルできるかどうかを確認できます。Event.cancelable の値が true の場合、preventDefault() を使用してイベントをキャンセルできます。それ以外の場合、preventDefault() の効果はありません。

関連する API エレメント

イベントフローの現在のノードおよび後続するノードで、イベントリスナーが処理されないようにします。このメソッドはすぐに有効になり、現在のノードのイベントリスナーに影響します。これに対し、stopPropagation() メソッドは、現在のノードのすべてのイベントリスナーの処理が終了するまで有効になりません。

注意：このメソッドは、このイベントに関連付けられている動作をキャンセルしません。その機能については、preventDefault() を参照してください。

関連する API エレメント

イベントフローの現在のノードに後続するノードで、イベントリスナーが処理されないようにします。このメソッドは、現在のノード（currentTarget）のイベントリスナーには影響しません。これに対し、stopImmediatePropagation() メソッドは、現在のノードとそれ以降のノードで、イベントリスナーが処理されないようにします。このメソッドを繰り返し呼び出しても影響はありません。このメソッドは、イベントフローの任意の段階で呼び出すことができます。

注意：このメソッドは、このイベントに関連付けられている動作をキャンセルしません。その機能については、preventDefault() を参照してください。

関連する API エレメント

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

[Event type=value bubbles=value cancelable=value]

ACTIVATE 定数は、type プロパティ（activate イベントオブジェクト）の値を定義します。

注意：このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、ターゲットが表示リストにあるかないかに関わらず、潜在的なターゲットにはイベントリスナーを直接追加する必要があります。

AIR for TV デバイスでは、このイベントが自動的に送出されることはありません。手動での送出は可能です。

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

関連する API エレメント

Event.ADDED 定数は、type プロパティ（added イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.ADDED_TO_STAGE 定数は、type プロパティ（addedToStage イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.BROWSER_ZOOM_CHANGE 定数は、browserZoomChange イベントオブジェクトの type プロパティの値を定義します。

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

関連する API エレメント

Event.CANCEL 定数は、type プロパティ（cancel イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.CHANGE 定数は、type プロパティ（change イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.CHANNEL_MESSAGE 定数は、channelMessage イベントオブジェクトの type プロパティの値を定義します。

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

関連する API エレメント

Event.CHANNEL_STATE 定数は、channelState イベントオブジェクトの type プロパティの値を定義します。

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

関連する API エレメント

Event.CLEAR 定数は、type プロパティ（clear イベントオブジェクト）の値を定義します。

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

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

関連する API エレメント

Event.CLOSE 定数は、type プロパティ（close イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.CLOSING 定数は、type プロパティ（closing イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.COMPLETE 定数は、type プロパティ（complete イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.CONNECT 定数は、type プロパティ（connect イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.CONTEXT3D_CREATE 定数は、context3Dcreate イベントオブジェクトの type プロパティの値を定義します。 このイベントは Stage3D オブジェクトでのみ発生します。このイベントは、Stage3D.requestContext3D の呼び出し、または Stage3D オブジェクトにバインドされた Context3D の リセット（OS によってトリガーされます）に応じて発生します。Stage3D.context3D プロパティを調べ、新規作成された Context3D オブジェクトを取得します。

関連する API エレメント

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

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

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

関連する API エレメント

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

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

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

関連する API エレメント

Event.DEACTIVATE 定数は、type プロパティ（deactivate イベントオブジェクト）の値を定義します。

注意：このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、ターゲットが表示リストにあるかないかに関わらず、潜在的なターゲットにはイベントリスナーを直接追加する必要があります。

AIR for TV デバイスでは、このイベントが自動的に送出されることはありません。手動での送出は可能です。

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

関連する API エレメント

Event.DISPLAYING 定数は、type プロパティ（displaying イベントオブジェクト）の値を定義します。

注意：このイベントは "キャプチャ段階" を経由せず、ターゲットが表示リストにあるかどうかにかかわらず、ターゲットに直接送出されます。

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

関連する API エレメント

Event.ENTER_FRAME 定数は、type プロパティ（enterFrame イベントオブジェクト）の値を定義します。

注意：このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、ターゲットが表示リストにあるかないかに関わらず、潜在的なターゲットにはイベントリスナーを直接追加する必要があります。

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

関連する API エレメント

Event.EXIT_FRAME 定数は、type プロパティ（exitFrame イベントオブジェクト）の値を定義します。

注意：このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、ターゲットが表示リストにあるかないかに関わらず、潜在的なターゲットにはイベントリスナーを直接追加する必要があります。

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

関連する API エレメント

Event.EXITING 定数は、type プロパティ（exiting イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.FRAME_CONSTRUCTED 定数は、type プロパティ（frameConstructed イベントオブジェクト）の値を定義します。

注意：このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、ターゲットが表示リストにあるかないかに関わらず、潜在的なターゲットにはイベントリスナーを直接追加する必要があります。

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

関連する API エレメント

Event.FRAME_LABEL 定数は、frameLabel イベントオブジェクトの type プロパティの値を定義します。

注意：このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、FrameLabel オブジェクトにイベントリスナーを直接追加する必要があります。

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

関連する API エレメント

Event.FULL_SCREEN 定数は、type プロパティ（fullScreen イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.HTML_BOUNDS_CHANGE 定数は、type プロパティ（htmlBoundsChange イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.HTML_DOM_INITIALIZE 定数は、type プロパティ（htmlDOMInitialize イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.HTML_RENDER 定数は、type プロパティ（htmlRender イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.ID3 定数は、type プロパティ（id3 イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.INIT 定数は、type プロパティ（init イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.LOCATION_CHANGE 定数は、type プロパティ（locationChange イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.MOUSE_LEAVE 定数は、type プロパティ（mouseLeave イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.NETWORK_CHANGE 定数は、type プロパティ（networkChange イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.OPEN 定数は、type プロパティ（open イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.PASTE 定数は、type プロパティ（paste イベントオブジェクト）の値を定義します。

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

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

関連する API エレメント

Event.PREPARING 定数は、preparing イベントオブジェクトの type プロパティの値を定義します。

注意：このイベントは "キャプチャ段階" を経由せず、ターゲットが表示リストにあるかどうかにかかわらず、ターゲットに直接送出されます。

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

関連する API エレメント

Event.REMOVED 定数は、type プロパティ（removed イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.REMOVED_FROM_STAGE 定数は、type プロパティ（removedFromStage イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.RENDER 定数は、type プロパティ（render イベントオブジェクト）の値を定義します。

注意：このイベントには「キャプチャ段階」と「バブリング段階」はありません。したがって、ターゲットが表示リストにあるかないかに関わらず、潜在的なターゲットにはイベントリスナーを直接追加する必要があります。

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

関連する API エレメント

Event.RESIZE 定数は、type プロパティ（resize イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.SCROLL 定数は、type プロパティ（scroll イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.SELECT 定数は、type プロパティ（select イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.SELECT_ALL 定数は、type プロパティ（selectAll イベントオブジェクト）の値を定義します。

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

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

関連する API エレメント

Event.SOUND_COMPLETE 定数は、type プロパティ（soundComplete イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.STANDARD_ERROR_CLOSE 定数は、standardErrorClose イベントオブジェクトの type プロパティの値を定義します。

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

Event.STANDARD_INPUT_CLOSE 定数は、standardInputClose イベントオブジェクトの type プロパティの値を定義します。

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

Event.STANDARD_OUTPUT_CLOSE 定数は、standardOutputClose イベントオブジェクトの type プロパティの値を定義します。

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

Event.SUSPEND 定数は、suspend イベントオブジェクトの type プロパティの値を定義します。このイベントは AIR iOS でのみ送出されます。

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

関連する API エレメント

Event.TAB_CHILDREN_CHANGE 定数は、type プロパティ（tabChildrenChange イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.TAB_ENABLED_CHANGE 定数は、type プロパティ（tabEnabledChange イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.TAB_INDEX_CHANGE 定数は、type プロパティ（tabIndexChange イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.TEXT_INTERACTION_MODE_CHANGE 定数は、interaction mode イベントオブジェクトの type プロパティの値を定義します。

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

関連する API エレメント

Event.TEXTURE_READY 定数は、textureReady イベントオブジェクトの type プロパティの値を定義します。このイベントは、非同期アップロードの完了を通知するために、Texture オブジェクトおよび CubeTexture オブジェクトによって送出されます。非同期アップロードは、Texture または CubeTexture の uploadCompressedTextureFromByteArray() メソッドを使用して要求します。このイベントはバブリングを行わず、キャンセル可能でもありません。

関連する API エレメント

Event.UNLOAD 定数は、type プロパティ（unload イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.USER_IDLE 定数は、type プロパティ（userIdle イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.USER_PRESENT 定数は、type プロパティ（userPresent イベントオブジェクト）の値を定義します。

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

関連する API エレメント

Event.VIDEO_FRAME 定数は、videoFrame イベントオブジェクトの type プロパティの値を定義します。

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

関連する API エレメント

Event.WORKER_STATE 定数は、workerState イベントオブジェクトの type プロパティの値を定義します。

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

関連する API エレメント