| パッケージ | mx.binding.utils |
| public class ChangeWatcher | |
| 継承 | ChangeWatcher 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 — 監視されるプロパティまたはプロパティチェーンを指定する値です。有効な値は次のとおりです。
メモ : |
|
handler:Function — 監視されるプロパティまたは監視されるチェーン内のプロパティの変更時に呼び出されるイベントハンドラ関数です。Watcher チェーン内のホストオブジェクトによって、そのホストオブジェクトの [Bindable] メタデータタグで監視対象プロパティに対して指定されたイベントが送出されたときに、変更が通知されます。デフォルトイベントの名前は propertyChange です。
バインド可能プロパティによって送出されたイベントオブジェクトは、変更がなくてもこのハンドラ関数に渡されます。デフォルトでは、PropertyChangeEvent 型のイベントオブジェクトが送出されます。ただし、 |
|
commitOnly:Boolean (default = false) — コミットする change イベントでのみハンドラを呼び出す場合は true に設定し、コミットする change イベントとコミットしない change イベントの両方でハンドラを呼び出す場合は false に設定します。メモ : プロパティに対するコミットしない change イベントの存在は、[NonCommittingChangeEvent(<event-name>)] メタデータタグで示されます。通常は、テキストフィールドでの確定前の変更などの詳細な値の変更を示すのに、これらのタグが使用されます。
|
ChangeWatcher —
少なくとも 1 つのプロパティ名が chain 引数に指定されている場合は ChangeWatcher インスタンス、それ以外の場合は null です。指定されたプロパティまたはプロパティチェーンに対するイベントをホストが公開していない場合があるため、返された Watcher が change イベントの検出と関連付けに成功したかどうかは保証されません。isWatching() メソッドを使用すると、Watcher の状態を確認できます。
|
このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート
現在のページ: http://livedocs.adobe.com/flex/2_jp/langref/mx/binding/utils/ChangeWatcher.html