パッケージmx.binding.utils
クラスpublic class BindingUtils
継承BindingUtils Inheritance Object

BindingUtils クラスは、ActionScript からデータバインディングを実行するユーティリティメソッドを定義します。 このクラスで定義されたメソッドを使用すると、データバインディングを設定できます。

関連項目

About data binding
Defining data bindings in ActionScript


パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義元
  
bindProperty(site:Object, prop:String, host:Object, chain:Object, commitOnly:Boolean = false):ChangeWatcher
[静的] site オブジェクトのパブリックプロパティ prop を、バインド可能なプロパティまたはプロパティチェーンにバインドします。
BindingUtils
  
bindSetter(setter:Function, host:Object, chain:Object, commitOnly:Boolean = false):ChangeWatcher
[静的] setter 関数 setter をバインド可能なプロパティまたはプロパティチェーンにバインドします。
BindingUtils
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
メソッドの詳細
bindProperty()メソッド
public static function bindProperty(site:Object, prop:String, host:Object, chain:Object, commitOnly:Boolean = false):ChangeWatcher

パブリックプロパティ propsite オブジェクト上)を、バインド可能なプロパティまたはプロパティチェーンにバインドします。 ChangeWatcher インスタンスが正常に作成されると、propchain の現在の値に初期化されます。

パラメータ

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

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

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

戻り値
ChangeWatcher — 少なくとも 1 つのプロパティ名が chain 引数に指定されている場合は ChangeWatcher インスタンスです。それ以外の場合は null です。
bindSetter()メソッド 
public static function bindSetter(setter:Function, host:Object, chain:Object, commitOnly:Boolean = false):ChangeWatcher

関数 settersetter をバインド可能なプロパティまたはプロパティチェーンにバインドします。 ChangeWatcher インスタンスが正常に作成されると、setter 関数は chain の現在の値である引数を指定して呼び出されます。

パラメータ

setter:Function — 値が変更されたときに、chain の現在の値を引数として指定して呼び出す setter メソッドです。
 
host:Object — プロパティのホストです。 詳細については、bindProperty() メソッドを参照してください。
 
chain:Object — プロパティまたはプロパティチェーンの名前です。 詳細については、bindProperty() メソッドを参照してください。
 
commitOnly:Boolean (default = false) — コミットする change イベントでのみハンドラを呼び出す場合は true に設定します。詳細については、bindProperty() メソッドを参照してください。

戻り値
ChangeWatcher — 少なくとも 1 つのプロパティ名が chain 引数に指定されている場合は ChangeWatcher インスタンスです。それ以外の場合は null です。




 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/mx/binding/utils/BindingUtils.html