Menu  - AS3 Flex

Пакет	mx.controls
Класс	public class Menu
Наследование	Menu List ListBase ScrollControlBase UIComponent FlexSprite Sprite DisplayObjectContainer InteractiveObject DisplayObject EventDispatcher Object
Реализует	IFocusManagerContainer
Подклассы	ScrollableMenu

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Элемент управления Menu создает всплывающее меню с вариантами выбора, подобное меню File или Edit, используемым в большинстве программных приложений. Всплывающее меню может иметь произвольное число подменю. После открытия элемента управления Menu, он остается видимым, пока не будет закрыт в результате одного из следующих действий:

• вызов метода Menu.hide();
• выбор активированного пункта меню;
• нажатие кнопки мыши вне элемента управления Menu;
• выбор другого компонента в приложении.

Класс Menu не имеет соответствующего тега MXML. Следует создать его с помощью ActionScript.

Элемент управления Menu имеет характеристики размеров, перечисленные ниже.

Характеристика	Описание
Размер по умолчанию	Ширина определяется из текста меню. Высота по умолчанию равна числу строк меню, умноженному на 19 пикселей для строки (высота строки по умолчанию).

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

   <mx:XML format="e4x" id="myMenuData">
     <root>
        <menuitem label="MenuItem A" icon="myTopIcon">
            <menuitem label="SubMenuItem A-1" enabled="False"/>
            <menuitem label="SubMenuItem A-2"/>
        </menuitem>
        <menuitem label="MenuItem B" type="check" toggled="true"/>
        <menuitem label="MenuItem C" type="check" toggled="false" icon="myTopIcon"/>
        <menuitem type="separator"/> 
        <menuitem label="MenuItem D" icon="myTopIcon">
            <menuitem label="SubMenuItem D-1" type="radio" groupName="one"/>
            <menuitem label="SubMenuItem D-2" type="radio" groupName="one" toggled="true"/>
            <menuitem label="SubMenuItem D-3" type="radio" groupName="one"/>
        </menuitem>
    </root>
 </mx:XML>

В следующей таблице приведены атрибуты, которые можно указать, типы их данных, их назначение, а также способ их отображения поставщиком данных при использовании класса DefaultDataDescriptor в меню для анализа поставщика данных:

Атрибут	Тип	Описание
включено	Логическое значение	Указывает, может ли пункт меню быть выбран пользователем (true) или нет (false). Если значение не указано, элемент обрабатывается так, как если бы имел значение true. При применении дескриптора данных по умолчанию для указания этой характеристики поставщиками данных должен использоваться атрибут XML enabled или поле объекта.
groupName	Строка	(Необходима и используется только для типа radio.) Идентификатор, связывающий элементы переключателей в группе переключателей. При использовании дескриптора данных по умолчанию поставщики данных должны использовать для указания этой характеристики атрибут XML groupName или поле объекта.
Значок	Класс	Указывает идентификатор класса ресурса изображений. Этот пункт не используется для типов check, radio или separator. Можно использовать стили checkIcon и radioIcon для указания значков, применяемых для выбранных переключателей и флажков. Свойство меню iconField или iconFunction определяет имя поля в данных, указывающее значок или функцию для определения значков.
label	Строка	Задает текст, отображаемый в элементе управления. Этот элемент используется для всех типов пунктов меню, за исключением separator. Свойство меню labelField или labelFunction определяет имя поля в составе данных, указывающего метку или функцию для определения меток. (Если поставщик данных имеет формат XML E4X, для отображения метки необходимо задать одно из этих свойств.) Если поставщиком данных является массив из строк, в качестве метки используется строковое значение.
toggled	Логическое значение	Указывает, выбран флажок или переключатель. Если значение не указано, элемент обрабатывается так, как если бы было установлено значение false и элемент не был выбран. При использовании дескриптора данных по умолчанию для указания этой характеристики в поставщиках данных необходимо применять атрибут XML toggled или поле объекта.
type	Строка	Указывает тип пункта меню. Возможными значениями являются separator, check или radio. Все другие значения или узлы без указания типа обрабатываются как обычные пункты меню. При использовании дескриптора данных по умолчанию для указания этой характеристики в поставщиках данных необходимо применять атрибут XML type или поле объекта.

Свойство MXML по умолчаниюdataProvider

Посмотреть примеры

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

---