MENU_ITEM_VALUE(3CURSES) Curses Library Functions MENU_ITEM_VALUE(3CURSES)

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

cc [ flag... ] file... -lmenu  -lcurses  [ library... ]
#include <menu.h>
int set_item_value(ITEM *item, int bool);

int item_value(ITEM *item);

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(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE
MT-Level Unsafe

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

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

December 31, 1996 OmniOS