menu_item_value(S-osr5)

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

Syntax

cc ... -lmenu -lcurses

#include <menu.h>

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

Description

set_item_value- set the select value of an item in a multivalued menu

item_value- return the select value of an item in a multivalued menu

Unlike single-valued menus, multi-valued menus enable the end-user to select one or more items from a menu.

set_item_value(S-osr5) 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(S-osr5) or menu_opts_off(S-osr5) to turn off the option O_ONEVALUE.

item_value(S-osr5) 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.

Warning

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

Files

/usr/lib/libmenu.a: the library

Standards conformance

set_item_value(S-osr5), and item_value(S-osr5) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.

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