Flex - Controle de Menu

Introdução

O controle Menu cria um menu pop-up de opções ou itens de menu selecionáveis individualmente. O menu pop-up pode ter quantos níveis de submenus forem necessários.

Declaração de Classe

A seguir está a declaração para mx.controls.Menu classe -

public class Menu 
   extends List 
      implements IFocusManagerContainer

Propriedades Públicas

Sr. Não	Descrição da Propriedade
1	dataDescriptor : IMenuDataDescriptor O objeto que acessa e manipula dados no provedor de dados.
2	hasRoot : Boolean [somente leitura] Um sinalizador que indica que o provedor de dados atual tem um nó raiz; por exemplo, um único nó superior em uma estrutura hierárquica.
3	parentMenu : Menu O menu pai em uma cadeia hierárquica de menus, onde o menu atual é um submenu do pai.
4	showRoot : Boolean Um sinalizador booleano que especifica se o nó raiz do provedor de dados deve ser exibido.

Métodos Públicos

Sr. Não	Método e Descrição
1	Menu() Construtor.
2	createMenu(parent:DisplayObjectContainer, mdp:Object, showRoot:Boolean = true):Menu [estático] Cria e retorna uma instância da classe Menu.
3	hide():void Oculta o controle Menu e qualquer um de seus submenus se o controle Menu estiver visível.
4	popUpMenu(menu:Menu, parent:DisplayObjectContainer, mdp:Object):void [estático] Define o dataProvider de um controle Menu existente e coloca o controle Menu no contêiner pai especificado.
5	show(xShow:Object = null, yShow:Object = null):void Mostra o controle do Menu.

Métodos Protegidos

Sr. Não	Método e Descrição
1	makeListData(data:Object, uid:String, rowNum:int):BaseListData [substituir] Cria uma nova instância MenuListData e preenche os campos com base no item do provedor de dados de entrada.
2	measure():void [substituir] Calcula a largura e altura preferidas do Menu com base nas larguras e alturas de seus itens de menu.
3	setMenuItemToggled(item:Object, toggle:Boolean):void Alterna o item de menu.

Eventos

Sr. Não	Descrição do Evento
1	change Enviado quando a seleção muda como resultado da interação do usuário.
2	itemClick Enviado quando um item de menu é selecionado.
3	itemRollOut Enviado quando um usuário rola o mouse para fora de um item de menu.
4	itemRollOver Enviado quando um usuário rola o mouse sobre um item de menu.
5	menuHide Enviado quando um menu ou submenu é descartado.
6	menuShow Enviado quando um menu ou submenu é aberto.

Métodos herdados

Esta classe herda métodos das seguintes classes -

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

Exemplo de controle de menu flexível

Vamos seguir as etapas a seguir para verificar o uso do controle Menu em um aplicativo Flex criando um aplicativo de teste -

Degrau	Descrição
1	Crie um projeto com um nome HelloWorld em um pacote com.tutorialspoint.client conforme explicado no capítulo Flex - Criar aplicativo .
2	Modifique HelloWorld.mxml conforme explicado abaixo. Mantenha o resto dos arquivos inalterados.
3	Compile e execute o aplicativo para ter certeza de que a lógica de negócios está funcionando de acordo com os requisitos.

A seguir está o conteúdo do arquivo mxml modificado 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>

Quando estiver pronto com todas as alterações feitas, vamos compilar e executar o aplicativo no modo normal como fizemos no capítulo Flex - Criar aplicativo . Se tudo estiver bem com sua aplicação, ele produzirá o seguinte resultado: [ ]

↰ Previous page