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 执行数据绑定的实用程序方法。您可以使用此类中定义的方法来配置数据绑定。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		bindProperty(site:Object, prop:String, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [静态] 将公用属性（site Object 上的 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

将公用属性（site Object 上的 prop）绑定到可绑定属性或属性链。如果已成功创建 ChangeWatcher 实例，则 prop 将初始化为 chain 的当前值。

参数

	`site:Object` — 定义绑定到 `chain` 的属性的 Object。

	`prop:String` — 在要绑定的 `site` Object 中定义的公用属性的名称。当 `chain` 值更改时，该属性将接收 `chain` 的当前值。

	`host:Object` — 用于承载要监视的属性或属性链的对象。`主机`维护当 `prop` 更改时要更新的`站点`列表。

	`chain:Object` — 用于指定要监视的属性或属性链的值。合法值包括：包含宿主对象公用可绑定属性名称的字符串。以下格式的 Object：`{ name: 属性名, getter: function(host) { return host[property name] } }`。此 Object 必须包含宿主对象的公用可绑定属性的名称和用于该属性的 getter 函数。包含前两个选项的组合的非空 Array，该数组表示可从宿主访问的可绑定属性链。例如，要绑定属性 `host.a.b.c`，需按以下形式调用该方法：`bindProperty(site, prop, host, ["a","b","c"])`。请注意：在 `chain` 参数中命名的属性必须是公用属性，因为 `describeType()` 方法抑制非公用属性的所有相关信息，包括 ChangeWatcher 在查找为给定属性公开的 change 事件时扫描的可绑定元数据。但是，在使用上述 `{ name, getter }` 参数形式时提供的 getter 函数可用于将任意计算值与指定的（公用）属性关联。

	`commitOnly:Boolean` (default = `false`) — 如果仅在提交 change 事件时需要调用处理函数，则设置为 `true`；如果无论是否提交 change 事件都调用处理函数，则设置为 `false`。请注意：属性是否存在不提交的 change 事件由 `[NonCommittingChangeEvent(<event-name>)]` 元数据标记来指示。通常，这些标记用于指示细化值更改，例如确认前在文本字段中进行的修改。

	`useWeakReference:Boolean` (default = `false`) — 确定对`站点`的引用是强还是弱。强引用（默认值）可防止`站点`被当作垃圾回收。弱引用则没有此作用。对于 Flex 4，已进行了添加。

ChangeWatcher — 如果已为 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()` 方法。`主机`维护当 `prop` 更改时要更新的 `setter` 列表。

	`chain:Object` — 属性或属性链的名称。有关详细信息，请参阅 `bindProperty()` 方法。

	`commitOnly:Boolean` (default = `false`) — 如果应仅在提交 change 事件时调用处理函数，则设置为 `true`。有关详细信息，请参阅 `bindProperty()` 方法。

	`useWeakReference:Boolean` (default = `false`) — 确定对 `setter` 的引用是强还是弱。强引用（默认值）可防止 `setter` 被当作垃圾回收。弱引用则没有此作用。对于 Flex 4，已进行了添加。

ChangeWatcher — 如果已为 chain 参数指定了至少一个属性名称，则返回 ChangeWatcher 实例；否则返回 null。

法律声明 | 在线隐私策略

BindingUtils - AS3 Flex

包x

语言元素

附录

包 mx.binding.utils

bindProperty

bindSetter