onChanged (TextField.onChanged ハンドラ)

イベントハンドラ/リスナー。テキストフィールドの内容が変更されると、呼び出されます。デフォルトは undefined です。スクリプトで定義できます。

onChanged ハンドラには、パラメータとしてテキストフィールドインスタンスへの参照が渡されます。イベントハンドラメソッドにパラメータを含めることによって、このデータを受け取ることができます。たとえば、次の例では、onChanged イベントハンドラで textfield_txt パラメータを受け取ります。その後、trace() ステートメントで、このパラメータを使用して、テキストフィールドのインスタンス名を [出力] パネルに表示します。

this.createTextField("myInputText_txt", 99, 10, 10, 300, 20);
myInputText_txt.border = true;
myInputText_txt.type = "input";

myInputText_txt.onChanged = function(textfield_txt:TextField) {
trace("the value of "+textfield_txt._name+" was changed. New value is: "+textfield_txt.text);
};

onChanged ハンドラは、ユーザーの操作によって変更が生じた場合にのみ呼び出されます。たとえば、ユーザーがキーボードで入力した場合や、マウスを使用してテキストフィールドの内容を変更した場合、メニューアイテムを選択した場合などです。プログラムによってテキストフィールドが変更されても、テキストフィールドに加えられる変更はコードから識別できるため、onChanged イベントはトリガされません。

パラメータ

Comments

Fumio Nonaka が Oct 11, 2005 の 7:18 PM に追加:

「メニューアイテムを選択した」だけでは、TextField.onChangedハン
ドラは呼出されないと思います。原文の"or selecting a menu
item"は、"using the mouse"とともに、"changing something in the
text field"にかかると解釈するのが妥当と考えます。

修正案:「たとえば、ユーザーがキーボードで入力した場合や、マウスを
使用したり、メニューアイテムを選択してテキストフィールドの内容を
変更した場合などです。」

もっとも、原文の構造は、現行日本語訳のように訳すのが適切にみえま
す。したがって原文も、"for example, when the user is typing
something on the keyboard, or changing something in the text
field using the mouse or selecting a menu item."とすべきだと思われ
ます。

onChanged (TextField.onChanged ハンドラ)

パラメータ

関連項目

Comments