Пакет | mx.binding.utils |
Класс | public class ChangeWatcher |
Наследование | ChangeWatcher Object |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Свойство | Определено | ||
---|---|---|---|
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
useWeakReference : Boolean
Определяет, является ли ссылка на handler «сильной» или «слабой». | ChangeWatcher |
Метод | Определено | ||
---|---|---|---|
ChangeWatcher(access:Object, handler:Function, commitOnly:Boolean = false, next:ChangeWatcher = null)
Конструктор. | ChangeWatcher | ||
[статические]
Позволяет определить, предоставляет ли хост событие привязки данных для свойства. | ChangeWatcher | ||
[статические]
Возвращает все события привязки для привязываемого свойства в хост-объекте. | ChangeWatcher | ||
Извлекает текущее значение наблюдаемого свойства или последовательности свойств или null, если значение хост-объекта равно null. | ChangeWatcher | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Возвращает значение true, если каждый наблюдатель в последовательности привязан по крайней мере к одному событию change. | ChangeWatcher | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Сбрасывает этот экземпляр ChangeWatcher для использования нового хост-объекта. | ChangeWatcher | ||
Выполняет настройку функции обработчика. | ChangeWatcher | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
Возвращает строковое представление заданного объекта. | Object | ||
Отсоединяет этот экземпляр ChangeWatcher и его функцию обработчика от текущего хоста. | ChangeWatcher | ||
Возвращает элементарное значение заданного объекта. | Object | ||
watch(host:Object, chain:Object, handler:Function, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher [статические]
Создает и запускает экземпляр ChangeWatcher. | ChangeWatcher |
useWeakReference | свойство |
public var useWeakReference:Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет, является ли ссылка на handler
«сильной» или «слабой». При «сильной» ссылке, указанной по умолчанию, handler
не будет собран сборщиком мусора. «Слабая» ссылка не выполняет эту функцию.
Значением по умолчанию является false.
ChangeWatcher | () | Конструктор |
public function ChangeWatcher(access:Object, handler:Function, commitOnly:Boolean = false, next:ChangeWatcher = null)
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор. Не для общего использования. Этот метод вызывается только из метода watch()
. Для получения информации об использовании параметра см. описание метода watch()
.
access:Object | |
handler:Function | |
commitOnly:Boolean (default = false )
| |
next:ChangeWatcher (default = null )
|
canWatch | () | метод |
public static function canWatch(host:Object, name:String, commitOnly:Boolean = false):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Позволяет определить, предоставляет ли хост событие привязки данных для свойства.
ПРИМЕЧАНИЕ. Метод canWatch()
не поддерживает цепочки свойств. Они поддерживаются методом watch()
.
Параметры
host:Object — Хост свойства. Для получения дополнительной информации см. описание метода watch() .
| |
name:String — Имя свойства. Для получения дополнительной информации см. описание метода watch() .
| |
commitOnly:Boolean (default = false ) — Устанавливает значение true , если вызов обработчика выполняется только для фиксирующих событий изменений. Для получения дополнительной информации см. описание метода watch() .
|
Boolean — Значение true , если host предоставляет события change для name .
|
getEvents | () | метод |
public static function getEvents(host:Object, name:String, commitOnly:Boolean = false):Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает все события привязки для привязываемого свойства в хост-объекте.
Параметры
host:Object — Хост свойства. Для получения дополнительной информации см. описание метода watch() .
| |
name:String — Имя свойства или последовательности свойств. Для получения дополнительной информации см. описание метода watch() .
| |
commitOnly:Boolean (default = false ) — Контролирует включение не фиксирующих событий изменений в возвращаемое значение.
|
Object — Объект формы { eventName: isCommitting, ... } , содержащей все события изменений для свойства.
|
getValue | () | метод |
public function getValue():Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Извлекает текущее значение наблюдаемого свойства или последовательности свойств или null, если значение хост-объекта равно null. Например:
watch(obj, ["a","b","c"], ...).getValue() === obj.a.b.cВозвращает
Object — Текущее значение наблюдаемого свойства или последовательности свойств.
|
isWatching | () | метод |
public function isWatching():Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает значение true
, если каждый наблюдатель в последовательности привязан по крайней мере к одному событию change. Обратите внимание, что использование метода isWatching()
зависит от хоста, так как различные хосты могут предоставлять различные события change для выбранного свойства наблюдателя.
Boolean — Значение true , если каждый наблюдатель в последовательности привязан по крайней мере к одному событию change.
|
reset | () | метод |
public function reset(newHost:Object):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сбрасывает этот экземпляр ChangeWatcher для использования нового хост-объекта. Этот метод можно вызвать для повторного использования экземпляра наблюдателя в другом хосте.
Параметры
newHost:Object — Новый хост свойства. Для получения дополнительной информации см. описание метода watch() .
|
setHandler | () | метод |
unwatch | () | метод |
public function unwatch():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Отсоединяет этот экземпляр ChangeWatcher и его функцию обработчика от текущего хоста. Метод reset()
можно использовать для прикрепления экземпляра ChangeWatcher или наблюдения этого свойства или последовательности свойств в другом хост-объекте.
watch | () | метод |
public static function watch(host:Object, chain:Object, handler:Function, commitOnly:Boolean = false, useWeakReference:Boolean = false):ChangeWatcher
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Создает и запускает экземпляр ChangeWatcher. Один экземпляр ChangeWatcher может наблюдать одно свойство или последовательность свойств. Последовательность свойств – это последовательность свойств, доступных из объекта хоста. Например, выражение obj.a.b.c
содержит последовательность свойств (a, b, c).
Параметры
host:Object — Объект, в котором размещается наблюдаемое свойство или последовательность свойств. Метод reset() можно использовать для изменения значения аргумента host после создания экземпляра ChangeWatcher. В host сохраняется список handler для вызова при изменении свойства prop .
| |
chain:Object — Значение, указывающее наблюдаемое свойство или последовательность. Допустимые значения:
Примечание. Свойство или свойства, имена которых указаны в аргументе | |
handler:Function — Функция обработчика события, вызываемая при изменении значения наблюдаемого свойства (или любого свойства в наблюдаемой последовательности свойств). Сигнал об изменении подается, когда любой хост-объект в последовательности наблюдателя передает событие, указанное в теге метаданных [Bindable] этого хост-объекта для соответствующего наблюдаемого свойства. Событие по умолчанию имеет имя propertyChange .
Объект события, передаваемый привязываемым свойством, поступает в функцию обработчика без изменения. По умолчанию Flex передает объект события типа PropertyChangeEvent. Однако при использовании тега метаданных | |
commitOnly:Boolean (default = false ) — Значение true , если вызов обработчика выполняется только для фиксирующих событий изменений; значение false , если вызов обработчика выполняется как для фиксирующих, так и для не фиксирующих событий изменений. Примечание. Наличие для свойства не фиксирующих событий изменений указывается в теге метаданных [NonCommittingChangeEvent(<event-name>)] . Обычно эти теги используются для указания изменений значений на уровне мелких структурных единиц, например изменения в текстовом поле до подтверждения.
| |
useWeakReference:Boolean (default = false ) — (default = false) Определяет, является ли ссылка на handler «сильной» или «слабой». При «сильной» ссылке, указанной по умолчанию, handler не будет собран сборщиком мусора. «Слабая» ссылка не выполняет эту функцию.
|
ChangeWatcher — Экземпляр ChangeWatcher, если для аргумента chain указано хотя бы одно имя свойства, в противном случае – значение null. Следует отметить, что возвращенный наблюдатель не обязательно успешно обнаружил и присоединился к событиям изменений, так как со стороны хоста могло не быть предоставленных событий для этого свойства или последовательности свойств. Для определения состояния наблюдателя можно воспользоваться методом isWatching() .
|
Связанные элементы API
Tue Jun 12 2018, 11:34 AM Z