| Пакет | mx.core |
| Класс | public class UIComponentDescriptor |
| Наследование | UIComponentDescriptor  ComponentDescriptor Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Большинство тегов в файле MXML описывает дерево объектов UIComponent. Например, тег <mx:Application> представляет объект UIComponent, а все нижестоящие контейнеры и элементы управления являются объектами UIComponent.
Компилятор MXML компилирует все теги MXML в экземпляр UIComponentDescriptor. А именно, компилятор MXML автоматически создает структуру данных ActionScript, которая является деревом объектов UIComponentDescriptor.
Во время выполнения метод createComponentsFromDescriptors() класса Container использует информацию в объектах UIComponentDescriptor в массиве контейнера childDescriptors для создания фактических объектов UIComponent, которые являются нижестоящими элементами контейнера, а также нижестоящих элементов более низкого уровня. В зависимости от значения свойства контейнера creationPolicy, нижестоящие элементы могут быть созданы во время запуска приложения, когда часть компонента становится видимой или когда разработчик приложений вручную вызывает метод createComponentsFromDescriptors().
Как правило, самостоятельное создание экземпляров UIComponentDescriptor не требуется; получение доступа к экземплярам, автоматически созданным компилятором MXML, осуществляется посредством массива класса Container childDescriptors.
Связанные элементы API
mx.core.Container.creationPolicy
mx.core.Container.createComponentsFromDescriptors()
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| document : Object
Ссылка на Object документа, в котором требуется создать компонент. | ComponentDescriptor | |
| effects : Array
Array, содержащий эффекты для компонента, указанные в MXML. | UIComponentDescriptor | ||
| events : Object
Object, содержащий пары «имя – значение» для обработчиков событий компонента, как указано в MXML. | ComponentDescriptor | |
| id : String
Идентификатор для компонента, как определено в MXML. | ComponentDescriptor | |
| properties : Object [только для чтения]
Object, содержащий пары «имя – значение» для свойств компонента, как указано в MXML. | ComponentDescriptor | |
| propertiesFactory : Function
Функция, возвращающая объект, который содержит пары «имя – значение» для свойств компонента, указанных в MXML. | ComponentDescriptor | |
| stylesFactory : Function
Функция, которая создает объект, содержащий пары «имя – значение» для стилей экземпляра компонента, указанных в MXML. | UIComponentDescriptor | ||
| type : Class
Класс компонента, как определено в MXML. | ComponentDescriptor | |
| Метод | Определено | ||
|---|---|---|---|
UIComponentDescriptor(descriptorProperties:Object)
Конструктор. | UIComponentDescriptor | ||
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Признает недействительным кэшируемое свойство properties. | ComponentDescriptor | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строку «ComponentDescriptor_» и значение свойства id. | ComponentDescriptor | |
|
Возвращает элементарное значение заданного объекта. | Object | |
effects | свойство |
public var effects:Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Array, содержащий эффекты для компонента, указанные в MXML.
Например, при написании следующего кода:
<mx:TextInput showEffect="Fade" hideEffect="Fade"/>
Свойство дескриптора effects является массивом [showEffect, hideEffect].
При отсутствии указания эффектов MXML для компонента свойство effects имеет значение null.
Учтите, что значения атрибутов эффекта в этом свойстве не определены. Эффекты обрабатываются как стили и поэтому включены в свойство stylesFactory. Массив effect только отслеживает, какие из стилей в свойстве stylesFactory фактически являются эффектами.
Эти свойства используются методом контейнера createComponentsFromDescriptors() для регистрации эффектов посредством EffectManager.
stylesFactory | свойство |
public var stylesFactory:Function| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Функция, которая создает объект, содержащий пары «имя – значение» для стилей экземпляра компонента, указанных в MXML.
Например, при написании следующего кода:
<mx:TextInput borderColor="0x888888" color="0xDDDDDD"/>
Свойство дескриптора stylesFactory имеет значение Function:
function():void { this.borderColor = 0x888888; this.color = 0xDDDDDD };
Если для экземпляра компонента не указаны стили MXML, свойство stylesFactory будет иметь значение null.
UIComponentDescriptor | () | Конструктор |
public function UIComponentDescriptor(descriptorProperties:Object)| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Конструктор.
ПараметрыdescriptorProperties:Object — Object, содержащий пары «имя – значение» для свойств объекта UIComponentDescriptor, как, например, type, id, propertiesFactory, events, stylesFactory и effects.
|
Tue Jun 12 2018, 11:34 AM Z