13. menu

<menu
  label = non empty token
  name = NMTOKEN
>
  Content: [ menu | separator | item | insert ]+
</menu>

<separator />

<insert />

<item
  label = non empty token
  icon = anyURI
  command = NMTOKEN
  parameter = string
>
  Content: [ accelerator ]?
</item>

<accelerator
  code = key code
  modifiers = possibly empty list of (ctrl|shift|alt|meta|altGr|mod)
/>

Specifies the label and content of the XML (placeholder) menu.

Note that the mnemonic of a menu or of a menu item is specified by adding an underscore ('_') before the character used as a mnemonic. Currently, only a-zA-Z0-1 characters can be used as mnemonics. Moreover, Java™ does not make a difference between an uppercase letter and a lowercase letter.

Example:

  <menu label="_XHTML">

    <menu label="_Table">
      <item label="Insert Column _After"
            icon="../icons/ColumnInsertAfter16.gif"
            command="xhtml.tableColumn" parameter="insertAfter"/>
      <item label="_Delete Column" 
            icon="../icons/ColumnDelete16.gif"
            command="xhtml.tableColumn" parameter="delete"/>
    </menu>

    <separator />

    <item label="_Go to Opposite Link End" 
          command="xhtml.crossReference" parameter="swap"/>

    <separator />

    <item label="Pre_view"
          icon="../icons/Refresh16.gif"
          command="xhtml.preview">
      <accelerator code="F5" />
    </item>

  </menu>

A menu configuration element can extend previously defined menu by using child element insert.

Example:

<include location="../common/common.incl" />
<!-- ==============================================
Let's suppose this menu is defined in common.incl:

<cfg:menu label="Menu">
  <cfg:item label="Insert..." command="insert" parameter="into" />
</cfg:menu>
=============================================== -->

<cfg:menu label="Menu2">
  <cfg:item label="Insert Before..." command="insert"
     parameter="before[implicitElement]" />
  <cfg:insert />
  <cfg:item label="Insert After..." command="insert" 
    parameter="after[implicitElement]" />
</cfg:menu>