mx.binding.utilsChangeWatcher ChangeWatcher クラスは、バインド可能な Flex プロパティと共に使用できるユーティリティメソッドを定義します。Object ChangeWatcher クラスは、バインド可能な Flex プロパティと共に使用できるユーティリティメソッドを定義します。これらのメソッドを使用すると、バインド可能プロパティが更新されるたびに実行されるイベントハンドラーを定義できます。 ChangeWatcher コンストラクターです。accesshandlercommitOnlyfalsenextmx.binding.utils:ChangeWatchernull コンストラクターです。パブリックでの使用を目的としていません。このメソッドは、watch() メソッドからのみ呼び出されます。パラメーターの使用法については、watch() メソッドを参照してください。 canWatch そのプロパティに対するデータバインディングイベントをホストが公開しているかどうかを判別できます。true なのは、hostが name に対する change イベントを公開している場合です。 hostプロパティのホストです。詳細については、watch() メソッドを参照してください。 nameプロパティの名前です。詳細については、watch() メソッドを参照してください。 commitOnlyfalseコミットする change イベントでのみハンドラーを呼び出す場合は true に設定します。詳細については、watch() メソッドを参照してください。そのプロパティに対するデータバインディングイベントをホストが公開しているかどうかを判別できます。

注意：プロパティチェーンは canWatch() メソッドではサポートされていません。 watch() メソッドでサポートされています。

getEvents ホストオブジェクトのバインド可能プロパティに対するすべてのバインディングイベントを返します。そのプロパティに対するすべての change イベントを含む { eventName: isCommitting, ... } 形式のオブジェクトです。 hostプロパティのホストです。詳細については、watch() メソッドを参照してください。 nameプロパティまたはプロパティチェーンの名前です。詳細については、watch() メソッドを参照してください。 commitOnlyfalseコミットしない change イベントを戻り値に入れるかどうかを制御します。ホストオブジェクトのバインド可能プロパティに対するすべてのバインディングイベントを返します。 getValue 監視されるプロパティまたはプロパティチェーンの現在の値を取得します。ホストオブジェクトが null の場合は null が取得されます。監視されるプロパティまたはプロパティチェーンの現在の値です。監視されるプロパティまたはプロパティチェーンの現在の値を取得します。ホストオブジェクトが null の場合は null が取得されます。次に実際の使用例を示します。

      watch(obj, ["a","b","c"], ...).getValue() === obj.a.b.c

isWatching チェーン内の各 Watcher に少なくとも 1 つの change イベントが関連付けられている場合は、true を返します。チェーン内の各 Watcher に少なくとも 1 つの change イベントが関連付けられている場合は、true です。チェーン内の各 Watcher に少なくとも 1 つの change イベントが関連付けられている場合は、true を返します。 Watcher で選択されたプロパティに対して発生する change イベントはホストによって異なる場合があるため、isWatching() メソッドはホストによって異なります。 reset この ChangeWatcher インスタンスをリセットして、新しいホストオブジェクトを使用します。newHostプロパティの新しいホストです。詳細については、watch() メソッドを参照してください。この ChangeWatcher インスタンスをリセットして、新しいホストオブジェクトを使用します。このメソッドを呼び出すと、別のホストにある Watcher インスタンスを再使用できます。 setHandler ハンドラー関数を設定します。handlerハンドラー関数です。この引数を null に指定しないでください。ハンドラー関数を設定します。 unwatch この ChangeWatcher インスタンスおよびハンドラー関数を現在のホストから削除します。この ChangeWatcher インスタンスおよびハンドラー関数を現在のホストから削除します。 reset() メソッドを使用すると、ChangeWatcher インスタンスを再追加し、異なるホストオブジェクトにある同じプロパティまたはプロパティチェーンを監視できます。 watch ChangeWatcher インスタンスを作成し、開始します。少なくとも１つのプロパティ名が chain 引数に指定されている場合は ChangeWatcher インスタンスです。それ以外の場合は null です。指定されたプロパティまたはプロパティチェーンに対するイベントをホストが公開していない場合があるため、返された Watcher が change イベントの検出と関連付けに成功したかどうかは保証されません。 isWatching() メソッドを使用すると、Watcher の状態を確認できます。 mx.binding.utils:ChangeWatcherhost監視されるプロパティまたはプロパティチェーンをホストするオブジェクトです。 reset() メソッドを使用すると、ChangeWatcher インスタンスを作成した後に host 引数の値を変更できます。host には、prop が変更されたときに起動する handlers のリストが保持されます。 chain監視されるプロパティまたはプロパティチェーンを指定する値です。有効な値は次のとおりです。

ホストオブジェクトのパブリックなバインド可能パブリックプロパティ名を含むストリングです。
{ name: property name, getter: function(host) { return host[name] } }.という形式のオブジェクトです。このオブジェクトには、パブリックなバインド可能プロパティ、およびそのプロパティの getter として機能する関数の名前が含まれます。
最初の２つのオプションの任意の組み合わせを含む空でない配列です。ホストからアクセスできるバインド可能プロパティのチェーンを表します。例えば、プロパティ host.a.b.c を監視するには、watch(host, ["a","b","c"], ...) のようにメソッドを呼び出します。

メモ：chain 引数で指定するプロパティはパブリックである必要があります。describeType() メソッドでは、パブリックでないプロパティに関する情報は返されないためです。パブリックでないプロパティには、特定のプロパティに対して公開されている change イベントを検索するために ChangeWatcher がスキャンする、バインド可能性を表すメタデータなどがあります。ただし、上記の { name, getter } 引数形式の使用時に getter 関数を指定すると、指定した（パブリック）プロパティに任意の計算結果を関連付けることができます。

handler監視されるプロパティまたは監視されるチェーン内のプロパティの変更時に呼び出されるイベントハンドラー関数です。変更が通知されるのは、Watcher チェーン内のホストオブジェクトが、そのホストオブジェクトの [Bindable] メタデータタグで監視対象プロパティの指定イベントを送出したときです。デフォルトイベントの名前は propertyChange です。

バインド可能プロパティが送出したイベントオブジェクトは、変更なしにこのハンドラー関数に渡されます。デフォルトでは、PropertyChangeEvent 型のイベントオブジェクトが送出されます。ただし、[Bindable] メタデータタグを使用してバインド可能プロパティを定義する場合、独自のイベントタイプを定義できます。

mx.events.PropertyChangeEvent

useWeakReference handler への参照が強参照と弱参照のいずれであるかを判断します。false handler への参照が強参照と弱参照のいずれであるかを判断します。デフォルトである強参照の場合は、handler のガベージコレクションが回避されます。弱参照では回避されません。 BindingUtils BindingUtils クラスは、ActionScript からデータバインディングを実行するユーティリティメソッドを定義します。Object BindingUtils クラスは、ActionScript からデータバインディングを実行するユーティリティメソッドを定義します。このクラスで定義されたメソッドを使用すると、データバインディングを設定できます。 bindProperty site オブジェクトのパブリックプロパティ prop を、バインド可能なプロパティまたはプロパティチェーンにバインドします。少なくとも 1 つのプロパティ名が chain 引数に指定されている場合は ChangeWatcher インスタンスです。それ以外の場合は null です。 mx.binding.utils:ChangeWatchersitechain にバインドされるプロパティを定義するオブジェクトです。 propバインドされる site オブジェクトに定義されているパブリックプロパティの名前です。 chain の現在の値をプロパティが受け取るのは、chain の値が変化するときです。 host監視されるプロパティまたはプロパティチェーンをホストするオブジェクトです。 host には、prop が変更されたときに更新する sites のリストが保持されます。 chain監視されるプロパティまたはプロパティチェーンを指定する値です。有効な値は次のとおりです。

ホストオブジェクトのパブリックなバインド可能パブリックプロパティの名前を含むストリングです。
{ name: property name, getter: function(host) { return host[property name] } } という形式のオブジェクトです。このオブジェクトには、ホストオブジェクトのパブリックでないバインド可能プロパティの名前および getter 関数が含まれている必要があります。
ホストからアクセスできるバインド可能プロパティのチェーンを表す最初の 2 つのオプションの組み合わせを含む空でない配列です。例えば、プロパティ host.a.b.c をバインドするには、bindProperty(site, prop, host, ["a","b","c"]) のようにメソッドを呼び出します。

commitOnlyfalseコミットする change イベントでのみハンドラーを呼び出す場合は true に設定し、コミットする change イベントとコミットしない change イベントの両方でハンドラーを呼び出す場合は false に設定します。メモ：プロパティについてコミットしない change イベントがあるかどうかは、[NonCommittingChangeEvent(<event-name>)] メタデータタグが示します。通常は、テキストフィールドでの確定前の変更などの詳細な値の変更を示すのに、これらのタグが使用されます。 useWeakReferencefalsesite への参照が強参照と弱参照のいずれであるかを判断します。デフォルトである強参照の場合は、site のガベージコレクションが回避されます。弱参照では回避されません。Flex 4 用に追加されました。パブリックプロパティ prop（site オブジェクト上）を、バインド可能なプロパティまたはプロパティチェーンにバインドします。 ChangeWatcher インスタンスが正常に作成されると、prop は chain の現在の値に初期化されます。 bindSetter setter 関数 setter をバインド可能なプロパティまたはプロパティチェーンにバインドします。少なくとも 1 つのプロパティ名が chain 引数に指定されている場合は ChangeWatcher インスタンスです。それ以外の場合は null です。 mx.binding.utils:ChangeWatchersetter値が変更されたときに、chain の現在の値を引数として指定して呼び出す setter メソッドです。 hostプロパティのホストです。詳細については、bindProperty() メソッドを参照してください。host には、prop が変更されたときに更新する setters のリストが保持されます。 chainプロパティまたはプロパティチェーンの名前です。詳細については、bindProperty() メソッドを参照してください。 commitOnlyfalseコミットする change イベントでのみハンドラーを呼び出す場合は true に設定します。詳細については、bindProperty() メソッドを参照してください。 useWeakReferencefalsesetter への参照が強参照と弱参照のいずれであるかを判断します。デフォルトである強参照の場合は、setter のガベージコレクションが回避されます。弱参照では回避されません。Flex 4 用に追加されました。 setter 関数 setter をバインド可能なプロパティまたはプロパティチェーンにバインドします。 ChangeWatcher インスタンスが正常に作成されると、setter 関数が呼び出されます。setter には次の関数シグネチャが必要です。

      function mySetterFunction(object:Object):void {
          //Do whatever you want with the value of the bound property.
      }

ここで、object には、chain の現在値が含まれます。