hV_GUI — Menu

The menu can handle up to 4 levels with up to 8 options per level.
It is not an object but a function.

A menu includes
  • on the top left side, the hierarchy of the selected item
  • on the right side, the options for the current item
  • on the bottom left side, a yellow Cancel button and a green OK button, when available.
The screen is saved before the menu opens and restored after.

Note the area used by the menu is darkened to improve readability.
To go from left to right, select Item 2121 on the right side.
To go from right to left, select Item 212 on the hierarchy on the left side. Pressing Item 2 goes back to the first picture.
Left, the OK button is not available because the Item 212 has more options, Item 2121 and Item 2122.
Right, the OK button is available because the menu Item 2121 has no further options.
Because dialog is a function, there's no setup except the content of the menu. 

The content of the menu is declared as an array of item. 
Code Editor

    









					
									

		
	





Each item includes an index and a label.

myMenuItems is the content of the menu and nItems the number of items. 




	

    

        

    

    

        

    










	

		
			

				
					
						


Both are required by the function menu.

To easily convert a string into an item, use 



					
										
					
						



	

    

        

    

    

        

    









					
									

		
	






	

		
			

				
					
						


To use a menu, define the following parameters:
  • LCD to which the button belongs, with &myLCD,
  • content of the menu and number of items,
  • text colour, 
  • hierarchy colour, on the left side,
  • items colour, on the right side.



					
										
					
						



	

    

        

    

    

        

    









					
									

		
	






	

		
			

				
					
						


The result is the index of the selected item, or 0x0000 if Cancel  is selected.

The menu size fits both landscape and portrait modes with automatic recognition of the orientation.