<handler>

イベントハンドラをオブジェクトに関連付けるタグ。

• name属性にはイベント名を書きます。<handler>タグの親タグにそのイベントが発生すると<handler>タグ内のスクリプトが実行されます。
• クラスの面からみると、イベントハンドラはオーバーライドされません。
• reference属性を使うと、<handler>タグの親以外の他のオブジェクトのイベントを拾うことができます。

イベントに反応してスクリプトを動作させるための記述には下記のサンプルの通り何通りもあります。 このサンプルで行くと、

• ささいなスクリプトはボタン１の例のように、<handler>を使うまでもなく属性値で記述。
• 込み入ったスクリプトはボタン２の例のように<handler>内に記述。
• イベント発生源よりも、作用対象側に記述するほうがいいならボタン３の例のようにreference属性で発生源を指定。
• 複数のイベントで同じ動作をさせたいならボタン４の例のように動作そのものは<method>に書いておき、各<handler>からアクセスする。

という感じで使い分けできます。自由度高いので好みの問題かもしれませんが。

<?xml version="1.0" encoding="UTF-8"?>
<canvas proxied="false" bgcolor="0xeeeeee"> 
  <simplelayout spacing="5"/>
 
  <button onclick="txt1.setText('ボタン１押されました')">ボタン１</button>
  <text name="txt1"/> 
 
  <button>ボタン２ 
    <handler name="onclick">
       txt2.setText("ボタン２押されました");
    </handler>
  </button>
  <text name="txt2"/> 
 
  <button name="btn3">ボタン３</button>
  <text>
     <handler name="onclick" reference="btn3">
        this.setText("ボタン３押されました");
     </handler>
  </text>
 
  <button>ボタン４ 
    <handler name="onclick">
      this.osareta();
    </handler>
    <method name="osareta">
       txt4.setText("ボタン４押されました");
    </method>
  </button>
  <text name="txt4"/> 
 
</canvas>