on(mouseEvent:Object) { // ここにステートメントを記述}
アクションをトリガするマウスイベントまたはキー押下を指定します。
パラメータ
mouseEvent:Object - mouseEvent は、"イベント" と呼ばれるトリガです。イベントが発生すると、中括弧 ({}) 内でそれに続くステートメントが実行されます。次の値のすべてを mouseEvent パラメータに指定できます。
- press - ポインタがボタン上にあるときにマウスボタンを押した場合。
- release - ポインタがボタン上にあるときにマウスボタンを離した場合。
- releaseOutside - ポインタがボタン上にあるときにマウスボタンを押し、そのままボタン領域の外側に移動してからボタンを離した場合。press イベントと dragOut イベントは両方とも、常に releaseOutside イベントより前に配置します。
メモ : このイベントは、System.capabilities.hasMouse が true である、または
System.capabilities.hasStylus が true の場合のみ Flash Lite でサポートされます。
- rollOut - ポインタがボタン領域の外側に移動した場合。
メモ : このイベントは、System.capabilities.hasMouse が true である、または System.capabilities.hasStylus が true の場合のみ Flash Lite でサポートされます。
- rollOver - マウスポインタがボタン上に移動した場合。
- dragOut - ポインタがボタン上にあるときにマウスボタンを押し、そのままボタン領域の外側に移動した場合。
- dragOver - ポインタがボタン上にあるときにマウスボタンを押し、そのままボタンの外側に移動し、またボタン上に戻った場合。
- keyPress "<key> " - 指定されたキーを押した場合。パラメータの key の部分には、[アクション] パネルのコードヒントで示されているように、キー定数を指定します。このパラメータを使用してキー入力を取得できます。つまり、特定のキーのビルトインビヘイビアを上書きできます。ボタンは、アプリケーションの任意の場所 (ステージ上またはステージ外) に配置できます。この技術には制約が 1 つあります。on() ハンドラを実行時に適用できないため、オーサリング時に適用する必要があります。必ず [制御]-[キーボードショートカットを無効] を選択してください。
[制御]-[ムービープレビュー] を使用してアプリケーションをテストすると、ビルトインビヘイビアを持つ特定のキーは上書きされません。
キー定数の一覧については、Key クラスを参照してください。
例
次のスクリプトでは、マウスを押したときに startDrag() 関数が実行され、マウスを離してオブジェクトをドロップしたときにon (release) 内のスクリプトが実行されます。
on(press) {
startDrag(this);
}
on(release) {
trace("X:"+this._x);
trace("Y:"+this._y);
stopDrag();
}
関連項目
onClipEvent ハンドラ, Key