Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
mx.core 

UIComponentDescriptor  - AS3 Flex

Пакетmx.core
Классpublic class UIComponentDescriptor
НаследованиеUIComponentDescriptor Inheritance ComponentDescriptor Inheritance Object

Язык версии: ActionScript 3.0
Версия продукта: Flex 3
Версии среды выполнения: Flash Player 9, AIR 1.1

Экземпляр UIComponentDescriptor инкапсулирует информацию, указанную в теге MXML для экземпляра визуального компонента.

Большинство тегов в файле MXML описывает дерево объектов UIComponent. Например, тег <mx:Application> представляет объект UIComponent, а все нижестоящие контейнеры и элементы управления являются объектами UIComponent.

Компилятор MXML компилирует все теги MXML в экземпляр UIComponentDescriptor. А именно, компилятор MXML автоматически создает структуру данных ActionScript, которая является деревом объектов UIComponentDescriptor.

Во время выполнения метод createComponentsFromDescriptors() класса Container использует информацию в объектах UIComponentDescriptor в массиве контейнера childDescriptors для создания фактических объектов UIComponent, которые являются нижестоящими элементами контейнера, а также нижестоящих элементов более низкого уровня. В зависимости от значения свойства контейнера creationPolicy, нижестоящие элементы могут быть созданы во время запуска приложения, когда часть компонента становится видимой или когда разработчик приложений вручную вызывает метод createComponentsFromDescriptors().

Как правило, самостоятельное создание экземпляров UIComponentDescriptor не требуется; получение доступа к экземплярам, автоматически созданным компилятором MXML, осуществляется посредством массива класса Container childDescriptors.

Связанные элементы API



Общедоступные свойства
 СвойствоОпределено
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
 Inheriteddocument : Object
Ссылка на Object документа, в котором требуется создать компонент.
ComponentDescriptor
  effects : Array
Array, содержащий эффекты для компонента, указанные в MXML.
UIComponentDescriptor
 Inheritedevents : Object
Object, содержащий пары «имя – значение» для обработчиков событий компонента, как указано в MXML.
ComponentDescriptor
 Inheritedid : String
Идентификатор для компонента, как определено в MXML.
ComponentDescriptor
 Inheritedproperties : Object
[только для чтения] Object, содержащий пары «имя – значение» для свойств компонента, как указано в MXML.
ComponentDescriptor
 InheritedpropertiesFactory : Function
Функция, возвращающая объект, который содержит пары «имя – значение» для свойств компонента, указанных в MXML.
ComponentDescriptor
  stylesFactory : Function
Функция, которая создает объект, содержащий пары «имя – значение» для стилей экземпляра компонента, указанных в MXML.
UIComponentDescriptor
 Inheritedtype : Class
Класс компонента, как определено в MXML.
ComponentDescriptor
Общедоступные методы
 МетодОпределено
  
UIComponentDescriptor(descriptorProperties:Object)
Конструктор.
UIComponentDescriptor
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Признает недействительным кэшируемое свойство properties.
ComponentDescriptor
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
 Inherited
Возвращает строку «ComponentDescriptor_» и значение свойства id.
ComponentDescriptor
 Inherited
Возвращает элементарное значение заданного объекта.
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.




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.