Keywords: Cmenu

Next: Processing return Values Up: Function Reference Previous: menu_item Contents

## menu_display

Activate a menu and let Cmenu do the menu navigation. This call will return user selections depending on the type of menu items included in the menu. Dealing with the return value can be quite complicated for complex menus.

It is normally called as

$sel = &menu_display(``User prompt'',start_item);

$sel
  This will contain user responses; it will always be terminated by separator character so chop it off with
  chop($sel);
  Generally this return value will contain a list of values which need further processing (see below).
User prompt
  (mandatory) a string which will be displayed at the foot of the screen
start_item
  (optional) which menu option should be highlighted at the start. This allows your script to keep track of where it was in a menu. If it is not provided, the first item in a menu will be highlighted.

Subsections

- Processing return Values