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 控件创建可分别选择的选项的弹出菜单，此弹出菜单类似于大多数软件应用程序中的“文件”或“编辑”菜单。弹出菜单可以具有所需的任何数目的子菜单级别。打开 Menu 控件后，此控件将一直可见，直到通过下列任一操作将其关闭：

• 调用 Menu.hide() 方法。
• 用户选择已启用的菜单项。
• 用户在 Menu 控件外部单击。
• 用户选择该应用程序中的其他组件。

Menu 类没有对应的 MXML 标签。必须使用 ActionScript 创建它。

Menu 控件具有下列大小特征：

特征	说明
默认大小	宽度取决于 Menu 文本。默认高度是菜单行数与默认行高（19 个像素/行）的乘积。

Menu 项目的数据提供程序可以指定多个属性，用于确定项目的显示和行为方式，如以下 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 类分析数据提供程序）：

属性	类型	说明
enabled	Boolean	指定用户可以选择菜单项 (true)，还是不可以选择菜单项 (false)。如果未指定，则 Flex 将假定该值为 true 来处理此项目。如果您使用默认数据说明符，则数据提供程序必须使用 enabledXML 属性或对象字段来指定此特征。
groupName	字符串	（仅对 radio 类型有意义并且是必需的）用于关联单选组中的单选按钮项目的标识符。如果使用默认数据描述符，则数据提供程序必须使用 groupNameXML 属性或对象字段来指定此特征。
icon	Class	指定图像资源的类标识符。此项目不适用于 check、radio 或 separator 类型。您可以使用 checkIcon 和 radioIcon 样式来指定一些图标，用于所选单选项目和复选框项目。菜单的 iconField 或 iconFunction 属性可以确定数据中用于指定图标的字段名称，或确定用于确定图标的函数。
label	字符串	指定控件中显示的文本。此项目适用于除 separator 之外的所有菜单项类型。菜单的 labelField 或 labelFunction 属性确定数据中指定标签的字段名称，或确定标签的函数。（如果数据提供程序采用 E4X XML 格式，则必须指定其中一个属性以显示标签。）如果数据提供程序是字符串数组，则 Flex 使用字符串值作为标签。
toggled	Boolean	指定选择复选项目还是单选项目。如果未指定，则 Flex 处理该项目的方式将视同该值为 false 一样，并且该项目是不选中的。如果使用默认数据描述符，则数据提供程序必须使用切换 XML 属性或对象字段来指定此特征。
type	字符串	指定菜单项的类型。有意义的值为 separator、check 或 radio。Flex 将其他所有值或无类型条目的节点视为常规菜单条目。如果使用默认数据描述符，则数据提供程序必须使用类型 XML 属性或对象字段来指定此特征。

默认 MXML 属性dataProvider

查看示例

相关 API 元素

---