Unlike single-valued menus, multi-valued menus enable the end-user to select one or more items from a menu. set_item_value() sets the selected value of the item -- TRUE (selected) or FALSE (not selected). set_item_value() may be used only with multi-valued menus. To make a menu multi-valued, use set_menu_opts or menu_opts_off() to turn off the option O_ONEVALUE. (See menu_opts(3CURSES)).

item_value() returns the select value of item, either TRUE (selected) or FALSE (unselected).

set_item_value() returns one of the following:

E_OK

The routine returned successfully.

E_SYSTEM_ERROR

System error.

E_REQUEST_DENIED

The menu driver could not process the request.

See attributes(5) for descriptions of the following attributes:

curses(3CURSES), menus(3CURSES), menu_opts(3CURSES), attributes(5)

The header <menu.h> automatically includes the headers <eti.h> and <curses.h>.