menu_item_value(3ocurses)

menu_item_value: set_item_value, item_value -- set and get menus item values

Synopsis

cc [flag . . .] file -lmenu -locurses [library . . .]

#include <menu.h>

int set_item_value(ITEM item, int bool);
int item_value(ITEM item);

Description

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(3ocurses)].

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

<Return> value

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.

Notices

The header file menu.h automatically includes the header files eti.h and ocurses.h.

References

curses(3ocurses), menus(3ocurses), menu_opts(3ocurses)

E_OK	-	The routine returned successfully.
E_SYSTEM_ERROR	-	System error.
E_REQUEST_DENIED	-	The menu driver could not process the request.