Flex - 選單控制元件

簡介

選單控制元件建立一個可單選的選項或選單項的彈出選單。彈出的選單可以根據需要具有任意級別的子選單。

類宣告

以下是mx.controls.Menu類的宣告：

public class Menu 
   extends List 
      implements IFocusManagerContainer

公共屬性

序號	屬性及描述
1	dataDescriptor : IMenuDataDescriptor 訪問和操作資料提供程式中資料的物件。
2	hasRoot : Boolean [只讀] 一個標誌，指示當前資料提供程式具有根節點；例如，分層結構中的單個頂級節點。
3	parentMenu : Menu 選單層次結構鏈中的父選單，其中當前選單是父選單的子選單。
4	showRoot : Boolean 一個布林標誌，指定是否顯示資料提供程式的根節點。

公共方法

序號	方法及描述
1	Menu() 建構函式。
2	createMenu(parent:DisplayObjectContainer, mdp:Object, showRoot:Boolean = true):Menu [靜態] 建立並返回 Menu 類的一個例項。
3	hide():void 隱藏 Menu 控制元件及其任何子選單（如果 Menu 控制元件可見）。
4	popUpMenu(menu:Menu, parent:DisplayObjectContainer, mdp:Object):void [靜態] 設定現有 Menu 控制元件的資料提供程式，並將 Menu 控制元件放置在指定的父容器中。
5	show(xShow:Object = null, yShow:Object = null):void 顯示 Menu 控制元件。

受保護的方法

序號	方法及描述
1	makeListData(data:Object, uid:String, rowNum:int):BaseListData [覆蓋] 建立一個新的 MenuListData 例項，並根據輸入資料提供程式項填充欄位。
2	measure():void [覆蓋] 根據選單項的寬度和高度計算選單的首選寬度和高度。
3	setMenuItemToggled(item:Object, toggle:Boolean):void 切換選單項。

序號

方法及描述

makeListData(data:Object, uid:String, rowNum:int):BaseListData

[覆蓋] 建立一個新的 MenuListData 例項，並根據輸入資料提供程式項填充欄位。

measure():void

[覆蓋] 根據選單項的寬度和高度計算選單的首選寬度和高度。

setMenuItemToggled(item:Object, toggle:Boolean):void

切換選單項。

事件

序號	事件及描述
1	change 由於使用者互動導致選擇更改時排程。
2	itemClick 選擇選單項時排程。
3	itemRollOut 使用者將滑鼠移出選單項時排程。
4	itemRollOver 使用者將滑鼠懸停在選單項上時排程。
5	menuHide 關閉選單或子選單時排程。
6	menuShow 開啟選單或子選單時排程。

繼承的方法

此類繼承自以下類：

mx.controls.List
mx.controls.listClasses.ListBase
mx.core.ScrollControlBase
mx.core.UIComponent
mx.core.FlexSprite
flash.display.Sprite
flash.display.DisplayObjectContainer
flash.display.InteractiveObject
flash.display.DisplayObject
flash.events.EventDispatcher
Object

Flex 選單控制元件示例

讓我們按照以下步驟來檢查 Flex 應用程式中選單控制元件的使用情況，方法是建立一個測試應用程式：

步驟	描述
1	在包com.tutorialspoint.client下建立一個名為HelloWorld的專案，如Flex - 建立應用程式章節中所述。
2	修改HelloWorld.mxml，如下所述。保持其餘檔案不變。
3	編譯並執行應用程式，以確保業務邏輯按要求工作。

以下是修改後的 mxml 檔案src/com.tutorialspoint/HelloWorld.mxml的內容。

<?xml version = "1.0" encoding = "utf-8"?>
<s:Application xmlns:fx = "http://ns.adobe.com/mxml/2009"
   xmlns:s = "library://ns.adobe.com/flex/spark"
   xmlns:mx = "library://ns.adobe.com/flex/mx"
   width = "100%" height = "100%" minWidth = "500" minHeight = "500">
   
   <fx:Style source = "/com/tutorialspoint/client/Style.css" />	
   <fx:Script>
      <![CDATA[
         import mx.controls.Menu;
         import mx.events.MenuEvent;
         
         protected var menu:Menu; 
         protected function showMenu(event:MouseEvent):void {
            menu = Menu.createMenu(null, menuData, false);
            menu.labelField = "@label";
            menu.show(mainContainer.x+menuPanel.x+ 2,
            mainContainer.y +menuPanel.y+32);
            menu.addEventListener(MenuEvent.CHANGE,onMenuChange);
         }

         protected function hideMenu(event:MouseEvent):void {
            menu.hide();
         }
         
         protected function onMenuChange(event:MenuEvent):void {
            lblSelected.text =  event.label;
         }
      ]]>
   </fx:Script>
   
   <fx:Declarations>
      <fx:XML format = "e4x" id = "menuData">
         <root>
            <menuitem label = "Menu Item A" >
               <menuitem label = "SubMenu Item A 1" enabled = "false" />
               <menuitem label = "SubMenu Item A 2" />
            </menuitem>
            
            <menuitem label = "Menu Item B" type = "check" toggled = "true" />
            <menuitem label = "Menu Item C" type = "check" toggled = "false" />
            <menuitem type = "separator" />
            
            <menuitem label = "Menu Item D" >
               <menuitem label = "SubMenu Item D 1" type = "radio" 
                  groupName = "one" />
               <menuitem label = "SubMenu Item D 2" type = "radio" 
                  groupName = "one" toggled = "true" />
               <menuitem label = "SubMenu Item D 3" type = "radio" 
                  groupName = "one" />
            </menuitem>
         </root>
      </fx:XML>
   </fx:Declarations>
   
   <s:BorderContainer width = "630" height = "480" id = "mainContainer" 
      styleName = "container">
      <s:VGroup width = "100%" height = "100%" gap = "50" 
         horizontalAlign = "center" verticalAlign = "middle">
         <s:Label id = "lblHeader" text = "Complex Controls Demonstration" 
            fontSize = "40" color = "0x777777" styleName = "heading" />
         
         <s:Panel id = "menuPanel" title = "Using Menu" width = "500" 
            height = "300">
            <s:layout>
               <s:VerticalLayout  gap = "10" verticalAlign = "middle" 
                  horizontalAlign = "center" />	
            </s:layout>		
            
            <s:HGroup>
               <s:Button label = "Show Menu" click = "showMenu(event)" />
               <s:Button label = "Hide Menu" click = "hideMenu(event)" />
            </s:HGroup>
            
            <s:HGroup>
               <s:Label text = "Menu Item selected:" />
               <s:Label id = "lblSelected" fontWeight = "bold" />	
            </s:HGroup>
         </s:Panel>
      </s:VGroup>	 
   </s:BorderContainer>	
</s:Application>

完成所有更改後，讓我們像在Flex - 建立應用程式章節中一樣，在普通模式下編譯並執行應用程式。如果應用程式一切正常，它將產生以下結果：[ 線上嘗試 ]

flex_complex_controls.htm

列印頁面