BindingUtils - Adobe ActionScript® 3（AS3 Flex）API リファレンス

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

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

さらに例を参照

About data binding
Defining data bindings in ActionScript

パブリックプロパティ

継承されるパブリックプロパティを隠す

継承されるパブリックプロパティを表示

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

パブリックメソッド

継承されるパブリックメソッドを隠す

継承されるパブリックメソッドを表示

	メソッド		定義元
		bindProperty(site:Object, prop:String, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [静的] site オブジェクトのパブリックプロパティ prop を、バインド可能なプロパティまたはプロパティチェーンにバインドします。	BindingUtils
		bindSetter(setter:Function, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [静的] setter 関数 setter をバインド可能なプロパティまたはプロパティチェーンにバインドします。	BindingUtils
		hasOwnProperty(name:String):Boolean オブジェクトに指定されたプロパティが定義されているかどうかを示します。	Object
		isPrototypeOf(theClass:Object):Boolean Object クラスのインスタンスが、パラメーターとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。	Object
		propertyIsEnumerable(name:String):Boolean 指定されたプロパティが存在し、列挙できるかどうかを示します。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void ループ処理に対するダイナミックプロパティの可用性を設定します。	Object
		toLocaleString():String ロケール固有の規則に従って書式設定された、このオブジェクトのストリング表現を返します。	Object
		toString():String 指定されたオブジェクトのストリング表現を返します。	Object
		valueOf():Object 指定されたオブジェクトのプリミティブな値を返します。	Object

メソッドの詳細

bindProperty

()

メソッド

 public static function bindProperty(site:Object, prop:String, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

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

パラメーター

	`site:Object` — `chain` にバインドされるプロパティを定義するオブジェクトです。

	`prop:String` — バインドされる `site` オブジェクトに定義されているパブリックプロパティの名前です。 `chain` の現在の値をプロパティが受け取るのは、`chain` の値が変化するときです。

	`host:Object` — 監視されるプロパティまたはプロパティチェーンをホストするオブジェクトです。 `host` には、`prop` が変更されたときに更新する `sites` のリストが保持されます。

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

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

	`useWeakReference:Boolean` (default = `false`) — `site` への参照が強参照と弱参照のいずれであるかを判断します。デフォルトである強参照の場合は、`site` のガベージコレクションが回避されます。弱参照では回避されません。Flex 4 用に追加されました。

戻り値

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

bindSetter

()

メソッド

 public static function bindSetter(setter:Function, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher

言語バージョン:

ActionScript 3.0

製品バージョン:

Flex 3

ランタイムバージョン:

Flash Player 9, AIR 1.1

setter 関数 setter をバインド可能なプロパティまたはプロパティチェーンにバインドします。 ChangeWatcher インスタンスが正常に作成されると、setter 関数が呼び出されます。setter には次の関数シグネチャが必要です。

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

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

パラメーター

	`setter:Function` — 値が変更されたときに、`chain` の現在の値を引数として指定して呼び出す setter メソッドです。

	`host:Object` — プロパティのホストです。詳細については、`bindProperty()` メソッドを参照してください。`host` には、`prop` が変更されたときに更新する `setters` のリストが保持されます。

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

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

	`useWeakReference:Boolean` (default = `false`) — `setter` への参照が強参照と弱参照のいずれであるかを判断します。デフォルトである強参照の場合は、`setter` のガベージコレクションが回避されます。弱参照では回避されません。Flex 4 用に追加されました。

戻り値

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

法律上の注意 | プライバシーポリシー

BindingUtils - AS3 Flex

クラス x

bindProperty

bindSetter