Go to main content

man pages section 3: Curses Library Functions

Exit Print View

Updated: July 2017
 
 

set_item_value(3CURSES)

Name

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 itemTRUE (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:

ATTRIBUTE TYPE
ATTRIBUTE VALUE
MT-Level
Unsafe

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>.