2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
4 <STRONG>mitem_value</STRONG> - set and get menu item values
9 <STRONG>#include</STRONG> <STRONG><menu.h></STRONG>
10 int set_item_value(ITEM *item, bool value);
11 bool item_value(const ITEM *item);
15 <H2>DESCRIPTION</H2><PRE>
16 If you turn off the menu option <STRONG>O_ONEVALUE</STRONG> (e.g., with
17 <STRONG>set_menu_opts</STRONG> or <STRONG>menu_opts_off</STRONG>; see <STRONG><A HREF="menu_opts.3x.html">menu_opts(3X)</A></STRONG>), the
18 menu becomes multi-valued; that is, more than one item may
19 simultaneously be selected.
21 In a multi_valued menu, you can used <STRONG>set_item_value</STRONG> to
22 select the given menu item (second argument <STRONG>TRUE</STRONG>) or dese-
23 lect it (second argument <STRONG>FALSE</STRONG>).
27 <H2>RETURN VALUE</H2><PRE>
28 The function <STRONG>set_item_value</STRONG> returns one of the following:
30 <STRONG>E_OK</STRONG> The routine succeeded.
32 <STRONG>E_SYSTEM_ERROR</STRONG>
33 System error occurred (see <STRONG>errno</STRONG>).
35 <STRONG>E_REQUEST_DENIED</STRONG>
36 The menu driver could not process the request.
40 <H2>SEE ALSO</H2><PRE>
41 <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="menu.3x.html">menu(3X)</A></STRONG>.
46 The header file <STRONG><menu.h></STRONG> automatically includes the header
47 file <STRONG><curses.h></STRONG>.
51 <H2>PORTABILITY</H2><PRE>
52 These routines emulate the System V menu library. They
53 were not supported on Version 7 or BSD versions.
58 Juergen Pfeifer. Manual pages and adaptation for new
59 curses by Eric S. Raymond.