blob: d2bde33d3dd8b8d4360f4297aa1c8da64d613c01 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
<HTML>
<BODY>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
</PRE>
<H2>NAME</H2><PRE>
<B>menu_items</B> - make and break connections between items and
menus
</PRE>
<H2>SYNOPSIS</H2><PRE>
<B>#include</B> <B><menu.h></B>
int set_menu_items(MENU *menu, ITEM **items);
ITEM **menu_items(const MENU *menu);
int item_count(const MENU *menu);
</PRE>
<H2>DESCRIPTION</H2><PRE>
The function <B>set_menu_items</B> changes the item pointer array
of the given <I>menu</I>. The array must be terminated by a
<B>NULL</B>.
The function <B>menu_items</B> returns the item array of the
given menu.
The function <B>item_count</B> returns the count of items in
<I>menu</I>.
</PRE>
<H2>RETURN VALUES</H2><PRE>
The function <B>menu_items</B> returns <B>NULL</B> on error.
The function <B>item_count</B> returns <B>ERR</B> (the general <B>curses</B>
error return value) on error.
The function <B>set_menu_items</B> returns one of the following
codes on error:
<B>E_OK</B> The routine succeeded.
<B>E_SYSTEM_ERROR</B>
System error occurred (see <B>errno</B>).
<B>E_BAD_ARGUMENT</B>
Routine detected an incorrect or out-of-range argu-
ment.
<B>E_POSTED</B>
The menu is already posted.
<B>E_NOT_CONNECTED</B>
No items are connected to the menu.
</PRE>
<H2>SEE ALSO</H2><PRE>
<B><A HREF="ncurses.3x.html">curses(3x)</A></B>, <B><A HREF="menu.3x.html">menu(3x)</A></B>.
</PRE>
<H2>NOTES</H2><PRE>
The header file <B><menu.h></B> automatically includes the header
file <B><curses.h></B>.
</PRE>
<H2>PORTABILITY</H2><PRE>
These routines emulate the System V menu library. They
were not supported on Version 7 or BSD versions.
The SVr4 menu library documentation specifies the
<B>item_count</B> error value as -1 (which is the value of <B>ERR</B>).
</PRE>
<H2>AUTHORS</H2><PRE>
Juergen Pfeifer. Manual pages and adaptation for new
curses by Eric S. Raymond.
</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
|