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

The BindingUtils class defines utility methods for performing data binding from ActionScript. You can use the methods defined in this class to configure data bindings.

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		bindProperty(site:Object, prop:String, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [靜態] Binds a public property, prop on the site Object, to a bindable property or property chain.	BindingUtils
		bindSetter(setter:Function, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [靜態] Binds a setter function, setter, to a bindable property or property chain.	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

Binds a public property, prop on the site Object, to a bindable property or property chain. If a ChangeWatcher instance is successfully created, prop is initialized to the current value of chain.

參數

	`site:Object` — The Object defining the property to be bound to `chain`.

	`prop:String` — The name of the public property defined in the `site` Object to be bound. The property will receive the current value of `chain`, when the value of `chain` changes.

	`host:Object` — The object that hosts the property or property chain to be watched. The `host` maintains a list of `sites` to update when `prop` changes.

	`chain:Object` — A value specifying the property or chain to be watched. Legal values are: String containing the name of a public bindable property of the host object. An Object in the form: `{ name: property name, getter: function(host) { return host[property name] } }`. This Object must contain the name of, and a getter function for, a public bindable property of the host object. A non-empty Array containing a combination of the first two options that represents a chain of bindable properties accessible from the host. For example, to bind the property `host.a.b.c`, call the method as: `bindProperty(site, prop, host, ["a","b","c"])`. Note: The property or properties named in the `chain` argument must be public, because the `describeType()` method suppresses all information about non-public properties, including the bindability metadata that ChangeWatcher scans to find the change events that are exposed for a given property. However, the getter function supplied when using the `{ name, getter }` argument form described above can be used to associate an arbitrary computed value with the named (public) property.

	`commitOnly:Boolean` (default = `false`) — Set to `true` if the handler should be called only on committing change events; set to `false` if the handler should be called on both committing and non-committing change events. Note: the presence of non-committing change events for a property is indicated by the `[NonCommittingChangeEvent(<event-name>)]` metadata tag. Typically these tags are used to indicate fine-grained value changes, such as modifications in a text field prior to confirmation.

	`useWeakReference:Boolean` (default = `false`) — Determines whether the reference to `site` is strong or weak. A strong reference (the default) prevents `site` from being garbage-collected. A weak reference does not. Added for Flex 4.

傳回值

ChangeWatcher — A ChangeWatcher instance, if at least one property name has been specified to the chain argument; null otherwise.

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

Binds a setter function, setter, to a bindable property or property chain. If a ChangeWatcher instance is successfully created, the setter function is invoked. The setter must have the following function signature:

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

where object contains the current value of chain.

參數

	`setter:Function` — Setter method to invoke with an argument of the current value of `chain` when that value changes.

	`host:Object` — The host of the property. See the `bindProperty()` method for more information. The `host` maintains a list of `setters` to update when `prop` changes.

	`chain:Object` — The name of the property, or property chain. See the `bindProperty()` method for more information.

	`commitOnly:Boolean` (default = `false`) — Set to `true` if the handler should be called only on committing change events. See the `bindProperty()` method for more information.

	`useWeakReference:Boolean` (default = `false`) — Determines whether the reference to `setter` is strong or weak. A strong reference (the default) prevents `setter` from being garbage-collected. A weak reference does not. Added for Flex 4.

傳回值

ChangeWatcher — A ChangeWatcher instance, if at least one property name has been specified to the chain argument; null otherwise.

法律聲明 | 線上隱私權政策

BindingUtils - AS3 Flex

類別 x

bindProperty

bindSetter