menu_item_value

, set_item_value

, item_value

- set and get menus item values

Synopsis

cc [ flag... ] file... -lmenu -lcurses [ 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(3CURSES)).

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

Return Values

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.

Attributes

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

See Also

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

Notes

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