「Buttonクラス」の版間の差分

2013年10月21日 (月) 22:01時点における版

Buttonクラスとは?

クリックやタッチなどの入力を受け取れることのできるクラスです。
LWFでは入力を受け取れるのは、このボタンクラスだけになります。
イベントリスナーを設定して特定の入力タイミングでスクリプトを実行したりすることが可能です。

ムービークリップと違いグラフィックを設定することはできず、ヒット領域のみの存在となります。
ヒット領域の設定にのみ唯一シェイプが使用できますが、回転していない矩形である必要があります

また、複数のボタンが重なっている場合は、一番上のボタンのみ反応します。

ボタンを作る

まず、適当なサイズの矩形シェイプを作りましょう。

適当なサイズの矩形シェイプを書く

その後、そのシェイプをボタンシンボルに変換します。シンボル名は適当なもの(英数)をつけてください

ボタンシンボルに変換

シンボル変換後、編集モードに入りシェイプが描画されているキーフレームを「アップ」→「ヒット」へ移動してください。

「アップ」→「ヒット」へキーフレームを移動

そして、編集モードを抜けると、半透明の水色の矩形ができあがっていると思います。
これがボタンのヒット領域になります。
Flash上では半透明の水色で表示されますが、LWFで実際に再生する際は何も表示されません。
ボタンにはインスタンス名を設定しておかないと使用できないので適当なインスタンス名を設定しましょう

ボタンにインスタンス名を設定

イベントを登録する

ボタンを使用するには、ボタンを押した時や離した時の挙動を登録する必要があります。
登録には Button.addEventListener を使用します。

下記の例では、ボタンを離した時にコンソールに"release"と出力します。

var handler = function(){
    console.log("release");
}
<Buttonインスタンス>.addEventListener("release", handler);

addEventListenerの第1引数にはイベントの種類
第2引数には実行する関数を入れます

イベントには下記の種類があります

ボタンにイベントリスナーを設定

イベントを解除する

ボタンに登録したイベントを解除したい場合、Button.removeEventListener 又は Button.clearEventListener を使用します。

<Buttonインスタンス>.removeEventListener("release", handler);

<Buttonインスタンス>.clearEventListener("release");

removeEventListener は登録した関数をひとつ解除することができます
第1引数にはイベントの種類
第2引数には 解除したい関数を入れてください。

clearEventListener は指定したイベントで登録されている関数をすべて解除します。
第1引数にはイベントの種類を入れてください。

タッチした座標を取得する

ボタンにタッチすると、タッチ座標が更新され取得することができます。
※何らかのイベントがセットされているボタンに限ります

ボタンに触れている間、下記のプロパティが更新され続けるので、その値を取得します

_root.lwf.pointX;
_root.lwf.pointY;

毎フレーム、タッチ座標をコンソールに出力し続けるサンプル

ボタンのサイズを取得する

ボタンのサイズは下記のサイズで取得することができます

<Buttonインスタンス>.width;     //幅
<Buttonインスタンス>.height;    //高さ