パッケージ | mx.binding.utils |
クラス | public class ChangeWatcher |
継承 | ChangeWatcher Object |
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
さらに例を参照
プロパティ | 定義元 | ||
---|---|---|---|
constructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクター関数への参照です。 | Object | ||
useWeakReference : Boolean
handler への参照が強参照と弱参照のいずれであるかを判断します。 | ChangeWatcher |
メソッド | 定義元 | ||
---|---|---|---|
ChangeWatcher(access:Object, handler:Function, commitOnly:Boolean = false, next:ChangeWatcher = null)
コンストラクターです。 | ChangeWatcher | ||
[静的]
そのプロパティに対するデータバインディングイベントをホストが公開しているかどうかを判別できます。 | ChangeWatcher | ||
[静的]
ホストオブジェクトのバインド可能プロパティに対するすべてのバインディングイベントを返します。 | ChangeWatcher | ||
監視されるプロパティまたはプロパティチェーンの現在の値を取得します。ホストオブジェクトが null の場合は null が取得されます。 | ChangeWatcher | ||
オブジェクトに指定されたプロパティが定義されているかどうかを示します。 | Object | ||
Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。 | Object | ||
チェーン内の各 Watcher に少なくとも 1 つの change イベントが関連付けられている場合は、true を返します。 | ChangeWatcher | ||
指定されたプロパティが存在し、列挙できるかどうかを示します。 | Object | ||
この ChangeWatcher インスタンスをリセットして、新しいホストオブジェクトを使用します。 | ChangeWatcher | ||
ハンドラー関数を設定します。 | ChangeWatcher | ||
ループ処理に対するダイナミックプロパティの可用性を設定します。 | Object | ||
ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。 | Object | ||
指定されたオブジェクトのストリング表現を返します。 | Object | ||
この ChangeWatcher インスタンスおよびハンドラー関数を現在のホストから削除します。 | ChangeWatcher | ||
指定されたオブジェクトのプリミティブな値を返します。 | Object | ||
watch(host:Object, chain:Object, handler:Function, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [静的]
ChangeWatcher インスタンスを作成し、開始します。 | ChangeWatcher |
useWeakReference | プロパティ |
public var useWeakReference:Boolean
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
handler
への参照が強参照と弱参照のいずれであるかを判断します。デフォルトである強参照の場合は、handler
のガベージコレクションが回避されます。弱参照では回避されません。
デフォルト値: false。
ChangeWatcher | () | コンストラクター |
public function ChangeWatcher(access:Object, handler:Function, commitOnly:Boolean = false, next:ChangeWatcher = null)
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
コンストラクターです。パブリックでの使用を目的としていません。 このメソッドは、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
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
そのプロパティに対するデータバインディングイベントをホストが公開しているかどうかを判別できます。
注意:プロパティチェーンは canWatch()
メソッドではサポートされていません。 watch()
メソッドでサポートされています。
パラメーター
host:Object — プロパティのホストです。 詳細については、watch() メソッドを参照してください。
| |
name:String — プロパティの名前です。詳細については、watch() メソッドを参照してください。
| |
commitOnly:Boolean (default = false ) — コミットする change イベントでのみハンドラーを呼び出す場合は true に設定します。 詳細については、watch() メソッドを参照してください。
|
Boolean — true なのは、host が name に対する change イベントを公開している場合です。
|
getEvents | () | メソッド |
public static function getEvents(host:Object, name:String, commitOnly:Boolean = false):Object
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ホストオブジェクトのバインド可能プロパティに対するすべてのバインディングイベントを返します。
パラメーター
host:Object — プロパティのホストです。 詳細については、watch() メソッドを参照してください。
| |
name:String — プロパティまたはプロパティチェーンの名前です。 詳細については、watch() メソッドを参照してください。
| |
commitOnly:Boolean (default = false ) — コミットしない change イベントを戻り値に入れるかどうかを制御します。
|
Object — そのプロパティに対するすべての change イベントを含む { eventName: isCommitting, ... } 形式のオブジェクトです。
|
getValue | () | メソッド |
isWatching | () | メソッド |
public function isWatching():Boolean
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
チェーン内の各 Watcher に少なくとも 1 つの change イベントが関連付けられている場合は、true
を返します。 Watcher で選択されたプロパティに対して発生する change イベントはホストによって異なる場合があるため、isWatching()
メソッドはホストによって異なります。
Boolean — チェーン内の各 Watcher に少なくとも 1 つの change イベントが関連付けられている場合は、true です。
|
reset | () | メソッド |
setHandler | () | メソッド |
unwatch | () | メソッド |
public function unwatch():void
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
この ChangeWatcher インスタンスおよびハンドラー関数を現在のホストから削除します。 reset()
メソッドを使用すると、ChangeWatcher インスタンスを再追加し、異なるホストオブジェクトにある同じプロパティまたはプロパティチェーンを監視できます。
watch | () | メソッド |
public static function watch(host:Object, chain:Object, handler:Function, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher
言語バージョン: | ActionScript 3.0 |
製品バージョン: | Flex 3 |
ランタイムバージョン: | Flash Player 9, AIR 1.1 |
ChangeWatcher インスタンスを作成し、開始します。 1 つの ChangeWatcher インスタンスで、1つのプロパティまたはプロパティチェーンを監視できます。 プロパティチェーンは、ホストオブジェクトからアクセスできる一連のプロパティです。 例えば、式 obj.a.b.c
にはプロパティチェーン(a、b、c)があります。
パラメーター
host:Object — 監視されるプロパティまたはプロパティチェーンをホストするオブジェクトです。 reset() メソッドを使用すると、ChangeWatcher インスタンスを作成した後に host 引数の値を変更できます。host には、prop が変更されたときに起動する handlers のリストが保持されます。
| |
chain:Object — 監視されるプロパティまたはプロパティチェーンを指定する値です。 有効な値は次のとおりです。
メモ: | |
handler:Function — 監視されるプロパティまたは監視されるチェーン内のプロパティの変更時に呼び出されるイベントハンドラー関数です。 変更が通知されるのは、Watcher チェーン内のホストオブジェクトが、そのホストオブジェクトの [Bindable] メタデータタグで監視対象プロパティの指定イベントを送出したときです。 デフォルトイベントの名前は propertyChange です。
バインド可能プロパティが送出したイベントオブジェクトは、変更なしにこのハンドラー関数に渡されます。 デフォルトでは、PropertyChangeEvent 型のイベントオブジェクトが送出されます。 ただし、 | |
commitOnly:Boolean (default = false ) — コミットする change イベントでのみハンドラーを呼び出す場合は true に設定し、コミットする change イベントとコミットしない change イベントの両方でハンドラーを呼び出す場合は false に設定します。 メモ:プロパティについてコミットしない change イベントがあるかどうかは、[NonCommittingChangeEvent(<event-name>)] メタデータタグが示します。 通常は、テキストフィールドでの確定前の変更などの詳細な値の変更を示すのに、これらのタグが使用されます。
| |
useWeakReference:Boolean (default = false ) — (default = false)handler への参照が強参照と弱参照のいずれであるかを判断します。デフォルトである強参照の場合は、handler のガベージコレクションが回避されます。弱参照では回避されません。
|
ChangeWatcher — 少なくとも1つのプロパティ名が chain 引数に指定されている場合は ChangeWatcher インスタンスです。それ以外の場合は null です。 指定されたプロパティまたはプロパティチェーンに対するイベントをホストが公開していない場合があるため、返された Watcher が change イベントの検出と関連付けに成功したかどうかは保証されません。 isWatching() メソッドを使用すると、Watcher の状態を確認できます。
|
関連する API エレメント
Tue Jun 12 2018, 10:34 AM Z