next up previous contents
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

Andy Ferguson (AFC) 2001-10-20