typical use of a menu is shown below, with its children of <menuitem>s and <menuseparator>s. Note, however, that the parent of a menuitem is not the menu itself, but rather a <floatinglist> that is implicity part of the menu. To access the menu from a menuitem (or any other subview) use the reference "parent.owner".

Example 1. using the menubar

<canvas debug="true" height="230">
  <debug y="100"/>
  <menubar width="200" >
    <menu text="Menu 1" width="100">
      <menuitem text="Item 1" onselect="canvas.whichOne(this);"/>
      <menuitem text="Item 2" onselect="canvas.whichOne(this);"/>
      <menuitem text="Item 3" onselect="canvas.whichOne(this);"/>
      <menuseparator/>           
      <menuitem text="Item 4" onselect="canvas.whichOne(this);"/>   
    </menu> 
    <menu text="Menu 2" width="100">
      <menuitem text="More items..." onselect="canvas.whichOne(this);"/>  
    </menu>
  </menubar>

  <method name="whichOne" args="vThis">
    Debug.write(vThis.parent.owner.text + " - "+ vThis.text);
  </method>
</canvas>

Example 2. simple menu

<canvas debug="true" height="235">
  <debug y="105"/>
  <button text="openMenu below">
    <menu name="topmenu" attach="bottom">
      <menuitem text="item 1"/>
      <menuitem text="item 2">
        <menu name="submenu">
          <menuitem text="subitem 1"/>
          <menuitem text="subitem 2"/>
        </menu>
      </menuitem>
    </menu>
    
    <handler name="onmousedown">
      this.topmenu.setOpen(true);
    </handler>
  </button>
</canvas>

Attributes
Name	Usage	Type (Tag)	Type (JS)	Default	Category
attach	Tag & JS	string	String	bottom	setter
	a string to indicate how the floating part of the menu attaches to the menubutton or menuitem. Possible values are: 'top', 'bottom', 'left', and 'right'

opened	Tag & JS	expression	any	false	setter
	a boolean indicating whether or not the menu is in opened

createChildren()
menu.createChildren(childrenarray)

Parameters
Name	Type	Desc
childrenarray		None

open()
menu.open(openit)
The general method to open/close a menu starting with itself and then moving 'up' the hierarchy to open/close the other menus in the hierarchy.
Parameters
Name	Type	Desc
openit	boolean	true opens menu, false closes it

setOpen()
menu.setOpen(isopened)
Only Hides and shows the floating list associated with the menu. It does not effect any other part of the menu's heirarchy. to open a menu within a heirarchy use open() instead of setOpen()
Parameters
Name	Type	Desc
isopened	boolean	true opens menu, false closes it

<menu>

Methods

close()
menu.close()
The general method to close a menu starting with itself and then moving 'down' the hierarchy to close all the other menus in the hierarchy.

getTopMenu()
menu.getTopMenu()
finds the top most menu in the heirarchy associated with this menu