ComponentDescriptor  - AS3 Flex

Ссылка на Object документа, в котором требуется создать компонент.

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

Object, содержащий пары «имя – значение» для обработчиков событий компонента, как указано в MXML.

Например, при вводе

      <mx:DataGrid id="dg" initialize="fetchData(); initDataGrid();"  change="changeHandler(event);"/>
      

свойством дескриптора events является объект

      { initialize: "__dg_initialize", change: "__dg_change" }
      

Свойством eventявляется null, если для компонента не указаны обработчики событий MXML.

Строки __dg_initialize и __dg_change являются именами методов обработчика события, автоматически создаваемые компилятором MXML. Тело этих методов содержит операторы ActionScript, определенные как значения атрибутов события. Например, автоматически созданным обработчиком initialize является

      public function __dg_initialize(event:mx.events.FlexEvent):void
      {
          fetchData();
          initDataGrid();
      }
      

Автоматически созданные обработчики события не всегда будут определяться по имени; в будущей версии Flex могут произойти изменения.

Эти свойства используются методом контейнера createComponentsFromDescriptors() для регистрации автоматически создаваемых обработчиков события с помощью метода addEventListener().

Идентификатор для компонента, как определено в MXML.

Например, при вводе

      <mx:TextInput id="firstName" text="Enter your first name here"/>
      

свойством дескриптора id является строка firstName.

Свойство id имеет значение null, если идентификатор MXML указан для компонента.

Значение свойства id становится именем общедоступной переменной в объекте документа MXML, автоматически созданной компилятором MXML. Значением этой переменной является ссылка на объект UIComponent, созданный из этого дескриптора. Это причина того, что можно, например, создать ссылку на элемент управления TextInput text как firstName.text из любого местоположения в документе, содержащем этот экземпляр TextInput.

Если свойство id определено, и это не пустая строка, оно также становится свойством name объекта DisplayObject. Если свойство id не определено или является пустым, свойство объекта DisplayObject name остается автоматически созданной строкой, например Button3, какой она возвращается методом NameUtil.createUniqueName(). Свойство name используется при создании строки, возвращенной методом toString(). Оно также может использоваться для нахождения компонента из его вышестоящего узла путем вызова getChildByName().

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

Object, содержащий пары «имя – значение» для свойств компонента, как указано в MXML.

Например, при вводе

      <mx:TextInput width="150" text="Hello"/>
      

свойством дескриптора properties является объект.

      { width: 150, text: "Hello" }
      

Свойство properties имеет значение null, если свойства MXML не указаны для компонента. В этом случае компонентом будут использоваться значения свойства по умолчанию.

Этот объект создается путем вызова функции, определенной свойством propertiesFactory и кэшированной для последующего доступа. Однако когда Repeater создает несколько экземпляров компонента из того же дескриптора, новая копия объекта properties должна создаваться для каждого экземпляра компонента; таким образом, они не используют совместно значения, которыми являются ссылки на массивы и объекты. Repeater выполняет это путем вызова на дескрипторе метода invalidateProperties().

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

Функция, возвращающая объект, который содержит пары «имя – значение» для свойств компонента, указанных в MXML.

Например, при вводе

      <mx:TextInput width="150" text="Hello">
      

свойством дескриптора propertiesFactory является функция:

      function():Object { return { width: 150, text: "Hello" }; }
      

Свойство propertiesFactoryимеет значение null, если свойства MXML не определены для компонента. В этом случае компонентом будут использоваться значения свойства по умолчанию.

Причина, по которой propertyFactory является функцией, возвращающей объект, а не фактическим объектом состоит в том, чтобы позволить дереву объектов ComponentDescriptor выполнить поэтапное «раскрытие». Если бы все дескрипторы в дереве дескриптора для документа создавались при запуске, время запуска было бы больше.

Свойство properties возвращает кэшируемый объект, который создан этой функцией фабрики.

Примечание. Обработчики событий, например click="doSomething();", отображаются в объекте events, а не в объекте properties.

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

Класс компонента, как определено в MXML.

Например, при вводе

      <mx:TextInput/>
      

свойством дескриптора type является классом mx.controls.TextInput.

Свойство никогда не имеет значение null для объектов ComponentDescriptor, созданных компилятором MXML, потому что каждый тег MXML имеет имя тега, например mx:TextInput.

Сопоставление тега MXML и его соответствующим классом определено пространством имен XML и файлом «манифеста», если таковые имеются и связаны с этим пространством имен. Например, стандартное пространство имен Flex http://www.adobe.com/2006/mxml представляемое префиксом mx: связано (в файле flex-config.xml) с файлом манифеста mxml-manifest.xml, и этот файл содержит тег

      <component id="TextInput" class="mx.controls.TextInput"/>
      

, что соответствует имени тега mx:TextInput классу mx.controls.TextInput. Учтите, что использование файла манифеста способствует соотнесению компонентов в одном пространстве имен с классами в нескольких пакетах ActionScript.

Конструктор.

Признает недействительным кэшируемое свойство properties. В следующий раз при чтении свойства properties свойства повторно создаются из функции, определенной значением свойства propertiesFactory.

Возвращает строку «ComponentDescriptor_» и значение свойства id.