menu_item_value(3CURSES)				     Curses Library Functions					  menu_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 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:

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

SunOS 5.10							    31 Dec 1996 					  menu_item_value(3CURSES)