1menu_item_value(3CURSES)   Curses Library Functions   menu_item_value(3CURSES)
2
3
4

NAME

6       menu_item_value,  set_item_value,  item_value  - set and get menus item
7       values
8

SYNOPSIS

10       cc [ flag... ] file... -lmenu  -lcurses  [ library... ]
11       #include <menu.h>
12
13       int set_item_value(ITEM *item, int bool);
14
15
16       int item_value(ITEM *item);
17
18

DESCRIPTION

20       Unlike single-valued menus, multi-valued menus enable the  end-user  to
21       select  one  or  more  items  from  a  menu.  set_item_value() sets the
22       selected value of the item — TRUE (selected) or FALSE  (not  selected).
23       set_item_value()  may  be  used only with multi-valued menus. To make a
24       menu multi-valued, use set_menu_opts or menu_opts_off() to turn off the
25       option O_ONEVALUE. (See menu_opts(3CURSES)).
26
27
28       item_value()  returns  the select value of item, either TRUE (selected)
29       or FALSE (unselected).
30

RETURN VALUES

32       set_item_value() returns one of the following:
33
34       E_OK                The routine returned successfully.
35
36
37       E_SYSTEM_ERROR      System error.
38
39
40       E_REQUEST_DENIED    The menu driver could not process the request.
41
42

ATTRIBUTES

44       See attributes(5) for descriptions of the following attributes:
45
46
47
48
49       ┌─────────────────────────────┬─────────────────────────────┐
50       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
51       ├─────────────────────────────┼─────────────────────────────┤
52       │MT-Level                     │Unsafe                       │
53       └─────────────────────────────┴─────────────────────────────┘
54

SEE ALSO

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

NOTES

59       The header <menu.h> automatically includes  the  headers   <eti.h>  and
60       <curses.h>.
61
62
63
64SunOS 5.11                        31 Dec 1996         menu_item_value(3CURSES)
Impressum