Flex - Controllo menu

introduzione

Il controllo Menu crea un menu a comparsa di scelte o voci di menu selezionabili singolarmente. Il menu visualizzato può avere tutti i livelli di sottomenu necessari.

Dichiarazione di classe

Di seguito è riportata la dichiarazione per mx.controls.Menu classe -

public class Menu 
   extends List 
      implements IFocusManagerContainer

Proprietà pubbliche

Suor n Proprietà e descrizione
1

dataDescriptor : IMenuDataDescriptor

L'oggetto che accede e manipola i dati nel fornitore di dati.

2

hasRoot : Boolean

[sola lettura] Un flag che indica che il fornitore di dati corrente ha un nodo radice; ad esempio, un singolo nodo superiore in una struttura gerarchica.

3

parentMenu : Menu

Il menu principale in una catena gerarchica di menu, dove il menu corrente è un sottomenu del menu principale.

4

showRoot : Boolean

Un flag booleano che specifica se visualizzare il nodo radice del provider di dati.

Metodi pubblici

Suor n Metodo e descrizione
1

Menu()

Costruttore.

2

createMenu(parent:DisplayObjectContainer, mdp:Object, showRoot:Boolean = true):Menu

[statico] Crea e restituisce un'istanza della classe Menu.

3

hide():void

Nasconde il controllo Menu e tutti i suoi sottomenu se il controllo Menu è visibile.

4

popUpMenu(menu:Menu, parent:DisplayObjectContainer, mdp:Object):void

[statico] Imposta il dataProvider di un controllo Menu esistente e posiziona il controllo Menu nel contenitore padre specificato.

5

show(xShow:Object = null, yShow:Object = null):void

Mostra il controllo del menu.

Metodi protetti

Suor n Metodo e descrizione
1

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

[override] Crea una nuova istanza MenuListData e popola i campi in base all'elemento del fornitore di dati di input.

2

measure():void

[override] Calcola la larghezza e l'altezza preferite del menu in base alla larghezza e all'altezza delle sue voci di menu.

3

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

Commuta la voce di menu.

Eventi

Suor n Descrizione dell'evento
1

change

Inviato quando la selezione cambia a seguito dell'interazione dell'utente.

2

itemClick

Inviato quando viene selezionata una voce di menu.

3

itemRollOut

Inviato quando un utente sposta il mouse fuori da una voce di menu.

4

itemRollOver

Inviato quando un utente passa il mouse su una voce di menu.

5

menuHide

Inviato quando un menu o un sottomenu viene chiuso.

6

menuShow

Inviato quando si apre un menu o sottomenu.

Metodi ereditati

Questa classe eredita i metodi dalle seguenti classi:

  • 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

Esempio di controllo del menu Flex

Seguiamo i seguenti passaggi per verificare l'utilizzo del controllo Menu in un'applicazione Flex creando un'applicazione di prova:

Passo Descrizione
1 Crea un progetto con un nome HelloWorld sotto un pacchetto com.tutorialspoint.client come spiegato nel capitolo Flex - Crea applicazione .
2 Modifica HelloWorld.mxml come spiegato di seguito. Mantieni il resto dei file invariato.
3 Compilare ed eseguire l'applicazione per assicurarsi che la logica aziendale funzioni secondo i requisiti.

Di seguito è riportato il contenuto del file mxml modificato 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>

Una volta che sei pronto con tutte le modifiche apportate, compiliamo ed eseguiamo l'applicazione in modalità normale come abbiamo fatto nel capitolo Flex - Crea applicazione . Se tutto va bene con la tua applicazione, produrrà il seguente risultato: [ Provalo online ]