PopUpMenuButton  - AS3 Flex

Дескриптор данных обращается к информации в поставщике данных и производит с ней различные операции.

При указании этого свойства в качестве атрибута в MXML необходимо использовать ссылку на дескриптор данных, а не на имя строки дескриптора. Используйте следующий формат для свойства:

<mx:PopUpMenuButton id="menubar" dataDescriptor="{new MyCustomDataDescriptor()}"/>

В качестве альтернативы, в MXML свойство может быть указано в качестве вложенного подтега, как представлено в примере:

<mx:PopUpMenuButton>
      <mx:dataDescriptor>
         <myCustomDataDescriptor>
      </mx:dataDescriptor>
      ...

Значением по умолчанию является внутренний экземпляр класса DefaultDataDescriptor.

Объект DataProvider для popUpMenu.

Значением по умолчанию является null.

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие collectionChange .

Имя поля в массиве dataProvider, содержащее пиктограммы, отображаемые для каждого элемента меню. При установке свойства iconFunction оно перезаписывает это свойство.

Средство визуализации выполняет в поставщике данных поиск свойства с именем, определенным для свойства iconField. Если значением этого свойства является класс, то он реализует этот класс и ожидает, что он станет экземпляром IflexDisplayObject. Если значением свойства является строка, то выполняется поиск свойства класса с именем в приложении. Если свойство в приложении невозможно найти, выполняется поиск в документе с этим именем и ожидается отображение этого свойства в классе.

Если поставщиком данных является объект E4X XML, необходимо установить это свойство явным способом, например использовать @icon для определения атрибута icon.

Значением по умолчанию является "icon".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие iconFieldChanged .

Функция, определяющая пиктограмму, отображаемую для каждого элемента меню. Если это свойство опускается, в программе Flex используется содержимое поля или атрибута, определяемое свойством iconField. При указании этого свойства, Flex игнорирует любое значение свойства iconField.

По умолчанию меню не отображает пиктограммы с текстом в строках. Однако указав функцию значка, можно определить класс для графического объекта, который создается и отображается в строке как значок.

Функция iconFunction принимает отдельный аргумент, являющийся элементом в поставщике данных, и возвращает класс:

Значением по умолчанию является null.

Имя поля в массиве Array объекта dataProvider, который содержит текст, отображаемый для каждого элемента меню. Если свойство labelFunction задано, то оно переопределяет данное свойство. Если поставщиком данных является массив строк, то Flex использует значения String в качестве меток. Если поставщик данных является объектом E4X XML, то данное свойство необходимо задать явным образом. Например, используйте строку @label для указания атрибута label.

Значением по умолчанию является "label".

Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие labelFieldChanged .

Функция, определяющая текст, который должен быть отображен для каждого из пунктов меню. При отсутствии этого свойства Flex использует содержимое поля или атрибута, определенного в свойстве labelField. Установка данного свойства приводит к игнорированию любого значения свойства labelField.

При задании этого свойства функция метки должна обнаружить соответствующее поле или поля и вернуть отображаемую строку. Свойство labelFunction можно также использовать для обработки форматирования и локализации.

В качестве аргумента функция метки принимает элемент в объекте dataProvider и возвращает элемент String, как показано в следующем примере:

labelFunction(item:Object):String

Значением по умолчанию является null.

Ссылка на всплывающий объект Menu.

Это свойство предназначено только для чтения. Установка этого свойства не приведет к выполнению каких-либо действий. Вместо этого следует задать свойство dataProvider. (Индикатор «Только для записи» отображается в сводке синтаксиса, так как свойство в суперклассе предназначено для чтения и записи, а этот класс переопределяет установщик пустой реализацией.)

Указывает необходимость отображения узла верхнего уровня или узлов поставщика данных. Если установлено значение false, то элемент управления отображает только нижестоящие элементы первого узла верхнего уровня. Все остальные узлы верхнего уровня игнорируются. Обычно это свойство имеет значение false для поставщиков данных XML формата E4X, где узлом верхнего уровня является объект документа.

Значением по умолчанию является true.

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

Передается, когда пользователь выбирает элемент из всплывающего меню.

Свойства объекта события для этого типа события имеют следующие значения. Не все свойства являются значимыми для каждого из видов событий. Дополнительную информацию см. в подробных описаниях свойств.