O'Reilly logo

DocBook 5: The Definitive Guide by Richard L. Hamilton, Norman Walsh

Stay ahead with the world's most comprehensive technology and business learning platform.

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, tutorials, and more.

Start Free Trial

No credit card required

Name

menuchoice — A selection or series of selections from a menu

Synopsis

menuchoice ::= (shortcut?, (guibutton | guiicon | guilabel | guimenu | guimenuitem | guisubmenu)+)

Description

In applications that present graphical user interfaces, it is often necessary to select an item, or a series of items, from a menu in order to accomplish some action. The menuchoice element provides a wrapper to contain the complete combination of selections.

Processing expectations

Formatted inline.

A menuchoice may generate arrows or other punctuation between multiple GUI elements. The shortcut may be suppressed, or sometimes it is presented in parentheses after the rest of the items.

See Also

accel, guibutton, guiicon, guilabel, guimenu, guimenuitem, guisubmenu, keycap, keycode, keycombo, keysym, mousebutton, shortcut

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example menuchoice</title>

<para>You can exit from GNU Emacs with 
<menuchoice>
  <shortcut>
    <keycombo><keysym>C-x</keysym><keysym>C-c</keysym></keycombo>
  </shortcut>
  <guimenu>Files</guimenu>
  <guimenuitem>Exit Emacs</guimenuitem>
</menuchoice>.
</para>

</article>

With Safari, you learn the way you learn best. Get unlimited access to videos, live online training, learning paths, books, interactive tutorials, and more.

Start Free Trial

No credit card required