mx.binding.utils.ChangeWatcher (Flex™ 2 リファレンスガイド)

	プロパティ	定義
		constructor : Object 指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。	Object
		prototype : Object [static] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。	Object

	メソッド	定義
		ChangeWatcher(access:Object, handler:Function, commitOnly:Boolean = false, next:ChangeWatcher = null) コンストラクタです。	ChangeWatcher
		canWatch(host:Object, name:String, commitOnly:Boolean = false):Boolean [static] そのプロパティに対するデータバインディングイベントをホストが公開しているかどうかを判別できます。	ChangeWatcher
		getEvents(host:Object, name:String, commitOnly:Boolean = false):Object [static] ホストオブジェクトのすべてのバインド可能プロパティに対するすべてのバインディングイベントを返します。	ChangeWatcher
		getValue():Object 監視されるプロパティまたはプロパティチェーンの現在の値を取得します。ホストオブジェクトが null の場合は null が取得されます。	ChangeWatcher
		hasOwnProperty(name:String):Boolean 指定されたプロパティがオブジェクトに定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		isWatching():Boolean チェーン内の各 Watcher に少なくとも 1 つの change イベントが関連付けられている場合は、`true` を返します。	ChangeWatcher
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		reset(newHost:Object):void この ChangeWatcher インスタンスをリセットして、新しいホストオブジェクトを使用します。	ChangeWatcher
		setHandler(handler:Function):void ハンドラ関数を設定します。	ChangeWatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		unwatch():void この ChangeWatcher インスタンスおよびハンドラ関数を現在のホストから削除します。	ChangeWatcher
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object
		watch(host:Object, chain:Object, handler:Function, commitOnly:Boolean = false):ChangeWatcher [static] ChangeWatcher インスタンスを作成し、開始します。	ChangeWatcher

コンストラクタの詳細

ChangeWatcher

()

コンストラクタ

public 関数 ChangeWatcher(access:Object, handler:Function, commitOnly:Boolean = false, next:ChangeWatcher = null)

コンストラクタです。パブリックでの使用を目的としていません。このメソッドは、watch() メソッドからのみ呼び出されます。パラメーターの使用法については、watch() メソッドを参照してください。

パラメータ

	`access:Object`

	`handler:Function`

	`commitOnly:Boolean` (default = `false`)

	`next:ChangeWatcher` (default = `null`)

メソッドの詳細

canWatch

()

メソッド

public static function canWatch(host:Object, name:String, commitOnly:Boolean = false):Boolean

そのプロパティに対するデータバインディングイベントをホストが公開しているかどうかを判別できます。

パラメータ

	`host:Object` — プロパティのホストです。詳細については、`watch()` メソッドを参照してください。

	`name:String` — プロパティまたはプロパティチェーンの名前です。詳細については、`watch()` メソッドを参照してください。

	`commitOnly:Boolean` (default = `false`) — コミットする change イベントでのみハンドラを呼び出す場合は `true` に設定します。詳細については、`watch()` メソッドを参照してください。

戻り値

Boolean — host が name に対する change イベントを公開している場合は true です。

getEvents

()

メソッド

public static function getEvents(host:Object, name:String, commitOnly:Boolean = false):Object

ホストオブジェクトのすべてのバインド可能プロパティに対するすべてのバインディングイベントを返します。

パラメータ

	`host:Object` — プロパティのホストです。詳細については、`watch()` メソッドを参照してください。

	`name:String` — プロパティまたはプロパティチェーンの名前です。詳細については、`watch()` メソッドを参照してください。

	`commitOnly:Boolean` (default = `false`) — コミットしない change イベントを戻り値に含めるかどうかを制御します。

戻り値

Object — そのプロパティに対するすべての change イベントを含む { eventName: isCommitting, ... } 形式のオブジェクトです。

getValue

()

メソッド

public function getValue():Object

監視されるプロパティまたはプロパティチェーンの現在の値を取得します。ホストオブジェクトが null の場合は null が取得されます。たとえば、次のようになります。

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

戻り値

Object — 監視されるプロパティまたはプロパティチェーンの現在の値です。

isWatching

()

メソッド

public function isWatching():Boolean

チェーン内の各 Watcher に少なくとも 1 つの change イベントが関連付けられている場合は、true を返します。Watcher で選択されたプロパティに対して発生する change イベントはホストによって異なる場合があるため、isWatching() メソッドはホストによって異なります。

戻り値

Boolean — チェーン内の各 Watcher に少なくとも 1 つの change イベントが関連付けられている場合は、true です。

reset

()

メソッド

public function reset(newHost:Object):void

この ChangeWatcher インスタンスをリセットして、新しいホストオブジェクトを使用します。このメソッドを呼び出すと、別のホストにある Watcher インスタンスを再使用できます。

パラメータ

newHost:Object — プロパティの新しいホストです。詳細については、watch() メソッドを参照してください。

setHandler

()

メソッド

public function setHandler(handler:Function):void

ハンドラ関数を設定します。

パラメータ

handler:Function — ハンドラ関数です。この引数を null に指定しないでください。

unwatch

()

メソッド

public function unwatch():void

この ChangeWatcher インスタンスおよびハンドラ関数を現在のホストから削除します。reset() メソッドを使用すると、ChangeWatcher インスタンスを再追加し、異なるホストオブジェクトにある同じプロパティまたはプロパティチェーンを監視できます。

watch

()

メソッド

public static function watch(host:Object, chain:Object, handler:Function, commitOnly:Boolean = false):ChangeWatcher

ChangeWatcher インスタンスを作成し、開始します。1 つの ChangeWatcher インスタンスで、1 つのプロパティまたはプロパティチェーンを監視できます。プロパティチェーンは、ホストオブジェクトからアクセスできる一連のプロパティです。たとえば、式 obj.a.b.c にはプロパティチェーン (a、b、c) があります。

パラメータ

	`host:Object` — 監視されるプロパティまたはプロパティチェーンをホストするオブジェクトです。`reset()` メソッドを使用すると、ChangeWatcher インスタンスを作成した後に `host` 引数の値を変更できます。

	`chain:Object` — 監視されるプロパティまたはプロパティチェーンを指定する値です。有効な値は次のとおりです。ホストオブジェクトのパブリックなバインド可能パブリックプロパティの名前を含むストリング。形式が `{ name: property name, getter: function(host) { return host[name] } }` のオブジェクト。このオブジェクトには、パブリックなバインド可能プロパティ、およびそのプロパティの getter として機能する関数の名前が含まれます。最初の 2 つのオプションの任意の組み合わせを含む空ではない配列。これは、ホストからアクセスできるバインド可能プロパティのチェーンを表します。たとえば、プロパティ `host.a.b.c` を監視するには、`watch(host, ["a","b","c"], ...)` のようにメソッドを呼び出します。メモ : `describeType()`メソッドでは、非パブリックプロパティに関する情報は返されないため、チェーンパラメータで指定するプロパティはパブリックである必要があります。非パブリックプロパティには、特定のプロパティに対して公開されている change イベントを検索するために ChangeWatcher がスキャンする、バインド可能性を表すメタデータなどがあります。ただし、上記の `{ name, getter }` 引数形式の使用時に getter 関数を指定すると、指定した (パブリック) プロパティに任意の計算結果を関連付けることができます。

	`handler:Function` — 監視されるプロパティまたは監視されるチェーン内のプロパティの変更時に呼び出されるイベントハンドラ関数です。Watcher チェーン内のホストオブジェクトによって、そのホストオブジェクトの `[Bindable]` メタデータタグで監視対象プロパティに対して指定されたイベントが送出されたときに、変更が通知されます。デフォルトイベントの名前は `propertyChange` です。バインド可能プロパティによって送出されたイベントオブジェクトは、変更がなくてもこのハンドラ関数に渡されます。デフォルトでは、PropertyChangeEvent 型のイベントオブジェクトが送出されます。ただし、`[Bindable]` メタデータタグを使用してバインド可能プロパティを定義する場合、独自のイベントタイプを定義できます。

	`commitOnly:Boolean` (default = `false`) — コミットする change イベントでのみハンドラを呼び出す場合は `true` に設定し、コミットする change イベントとコミットしない change イベントの両方でハンドラを呼び出す場合は `false` に設定します。メモ : プロパティに対するコミットしない change イベントの存在は、`[NonCommittingChangeEvent(<event-name>)]` メタデータタグで示されます。通常は、テキストフィールドでの確定前の変更などの詳細な値の変更を示すのに、これらのタグが使用されます。

戻り値

ChangeWatcher — 少なくとも 1 つのプロパティ名が chain 引数に指定されている場合は ChangeWatcher インスタンス、それ以外の場合は null です。指定されたプロパティまたはプロパティチェーンに対するイベントをホストが公開していない場合があるため、返された Watcher が change イベントの検出と関連付けに成功したかどうかは保証されません。isWatching() メソッドを使用すると、Watcher の状態を確認できます。

Adobe^® Flex™ 2 リファレンスガイド		すべてのパッケージ \| すべてのクラス \| \| 索引 \| 付録 \| 規則 \| フレーム内に表示フレームなしバージョン
Class ChangeWatcher	プロパティ \| メソッド

パッケージ	mx.binding.utils
	public class ChangeWatcher
継承	ChangeWatcher Object