BindingUtils - Adobe ActionScript® 3 (AS3 Flex)

Пакет	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 [статические] Выполняет привязку общедоступного свойства, свойство prop в объекте site, к привязываемому свойству или последовательности свойств.	BindingUtils
		bindSetter(setter:Function, host:Object, chain:Object, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [статические] Выполняет привязку функции установщика, 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` сохраняется список `site` для обновления при изменении свойства `prop`.

	`chain:Object` — Значение, указывающее наблюдаемое свойство или последовательность. Допустимые значения: Строка, содержащая имя общедоступного привязываемого свойства хост-объекта. Объект в форме: `{ name: имя свойства, getter: function(host) { return host[имя свойства] } }`. Этот объект должен содержать имя и функцию получателя для общедоступного привязываемого свойства хост-объекта. Непустой массив, содержащий комбинацию первых двух вариантов, которая представляет собой последовательность привязываемых свойств, доступных из хоста. Например, для выполнения привязки свойства `host.a.b.c` метод вызывается в следующем виде: `bindProperty(site, prop, host, ["a","b","c"])`. Примечание. Свойство или свойства, имена которых указаны в аргументе `chain`, должны быть общедоступными, так как метод `describeType()` подавляет любую информацию о не общедоступных свойствах, в т.ч. метаданные о возможности привязки, сканируемые ChangeWatcher при поиске событий изменений, которые предоставлены для этого свойства. Однако функцию получателя, предоставленную при использовании вышеописанной формы аргумента `{ name, getter }`, можно использовать для связывания произвольно вычисленного значения с именованным (общедоступным) свойством.

	`commitOnly:Boolean` (default = `false`) — Значение `true`, если вызов обработчика выполняется только для фиксирующих событий изменений; значение `false`, если вызов обработчика выполняется как для фиксирующих, так и для не фиксирующих событий изменений. Примечание. Наличие для свойства не фиксирующих событий изменений указывается в теге метаданных `[NonCommittingChangeEvent(<event-name>)]`. Обычно эти теги используются для указания изменений значений на уровне мелких структурных единиц, например изменения в текстовом поле до подтверждения.

	`useWeakReference:Boolean` (default = `false`) — Определяет, является ли ссылка на `site` «сильной» или «слабой». При «сильной» ссылке, указанной по умолчанию, `site` не будет собран сборщиком мусора. «Слабая» ссылка не выполняет эту функцию. Добавлено для Flex 4.

Возвращает

ChangeWatcher — Экземпляр ChangeWatcher, если для аргумента chain указано по крайней мере одно имя свойства; в противном случае – 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, к привязываемому свойству или последовательности свойств. Если экземпляр ChangeWatcher успешно создан, то вызывается функция установщика. Установщик должен иметь следующую подпись функции:

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

где object содержит текущее значение chain.

Параметры

	`setter:Function` — Метод установщика, запускаемый с аргументом текущего значения `chain` при изменении этого значения.

	`host:Object` — Хост свойства. Для получения дополнительной информации см. описание метода `bindProperty()`. В `host` сохраняется список `setter` для обновления при изменении свойства `prop`.

	`chain:Object` — Имя свойства или последовательности свойств. Для получения дополнительной информации см. описание метода `bindProperty()`.

	`commitOnly:Boolean` (default = `false`) — Устанавливает значение `true`, если вызов обработчика выполняется только для фиксирующих событий изменений. Для получения дополнительной информации см. описание метода `bindProperty()`.

	`useWeakReference:Boolean` (default = `false`) — Определяет, является ли ссылка на `setter` «сильной» или «слабой». При «сильной» ссылке, указанной по умолчанию, `setter` не будет собран сборщиком мусора. «Слабая» ссылка не выполняет эту функцию. Добавлено для Flex 4.

Возвращает

Юридическая информация | Политика конфиденциальности онлайн

BindingUtils - AS3 Flex

Классы x

bindProperty

bindSetter