Returns a new allocated menu item of type with a given name and description. It can throw an error if the strings are too large or if a memory allocation error occurs.
Given a menu and an item that has been attached to that
menu, this procedure sets item to be the current item. It
returns an integer that will be one of
E_NOT_CONNECTED if not menu items are
attached to this menu, or
Returns the current item for menu.
This procedure sets menu’s top row to be row. row is an integer where zero indicates that the first row is the top row.
This procedure will only have an effect when there are more rows in
the menu than are displayed on the screen. If all the menu items can
be displayed, this procedure will have no effect and return
The number of rows and columns that a menu displays is set by
It will return one of
E_NOT_CONNECTED if no menu items are attached to this menu, or
Returns the number of the top menu row being displayed, or
This procedure returns the zero-origin index of this item in its
containing menu’s item list or
#f on failure.
Returns, as a string, the name of the menu item item.
Returns, as a string, the description of the menu item item.
These functions set or query the bit mask for item. There is
only one option bit mask,
O_SELECTABLE. When this is on, the
item may be selected during menu processing. It defaults to on.
set-item-opts sets the bit mask of item to
menu-opts-on turns the bits of opts on in item.
menu-opts-off turns off the bits on opts in
These routines will return
E_OK on success or
E_SYSTEM_ERROR on failure.
This procedure returns the options bit mask of item.
If the menu option
O_ONEVALUE is turned off, the menu can have
more than one item selected simultaneously. In this case, the
item-value can be used to query item to see if
it is selected. It returns
An item can be selected with the procedure
which takes a menu item and a boolean value. It returns
#t if item is mapped onto the screen. If a menu
has more menu items than can be displayed at once, only some of the
menu items will be mapped onto the screen.