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 Object 上的 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

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

参数

site:Object — 定义绑定到 chain 的属性的 Object。
 
prop:String — 在要绑定的 site Object 中定义的公用属性的名称。当 chain 值更改时,该属性将接收 chain 的当前值。
 
host:Object — 用于承载要监视的属性或属性链的对象。
 
chain:Object — 用于指定要监视的属性或属性链的值。合法值包括:
  • 包含宿主对象公用可绑定属性名称的字符串。
  • 以下格式的 Object:{ name: 属性名, getter: function(host) { return host[property name] } }。此 Object 必须包含宿主对象的公用可绑定属性的名称和用于该属性的 getter 函数。
  • 包含前两个选项的组合的非空 Array,该数组表示可从宿主访问的可绑定属性链。例如,要绑定属性 host.a.b.c,需按以下形式调用此方法:bindProperty(host, ["a","b","c"], ...)

请注意:在 chain 参数中命名的属性必须是公用属性,因为 describeType() 方法抑制非公用属性的所有相关信息,包括 ChangeWatcher 在查找为给定属性公开的 change 事件时扫描的可绑定元数据。但是,在使用上述 { name, getter } 参数形式时提供的 getter 函数可用于将任意计算值与指定的(公用)属性关联。

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

返回
ChangeWatcher — 如果已为 chain 参数指定了至少一个属性名称,则返回 ChangeWatcher 实例;否则返回 null。
bindSetter()方法 
public static function bindSetter(setter:Function, host:Object, chain:Object, commitOnly:Boolean = false):ChangeWatcher

将 setter 函数(setter)绑定到可绑定属性或属性链。如果已成功创建 ChangeWatcher 实例,则调用 setter 函数,其中一个参数为 chain 的当前值。

参数

setter:Functionchain 的当前值更改时使用该值的参数进行调用的 Setter 方法。
 
host:Object — 属性的宿主。有关详细信息,请参阅 bindProperty() 方法。
 
chain:Object — 属性或属性链的名称。有关详细信息,请参阅 bindProperty() 方法。
 
commitOnly:Boolean (default = false) — 如果应仅在提交 change 事件时调用处理函数,则设置为 true。有关详细信息,请参阅 bindProperty() 方法。

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