4 <STRONG>menu_items</STRONG> - make and break connections between items and
10 <STRONG>#include</STRONG> <STRONG><menu.h></STRONG>
11 int set_menu_items(MENU *menu, ITEM **items);
12 ITEM **menu_items(const MENU *menu);
13 int item_count(const MENU *menu);
17 <H2>DESCRIPTION</H2><PRE>
18 The function <STRONG>set_menu_items</STRONG> changes the item pointer array
19 of the given <EM>menu</EM>. The array must be terminated by a
20 <STRONG>NULL</STRONG>.
22 The function <STRONG>menu_items</STRONG> returns the item array of the
25 The function <STRONG>item_count</STRONG> returns the count of items in
30 <H2>RETURN VALUES</H2><PRE>
31 The function <STRONG>menu_items</STRONG> returns <STRONG>NULL</STRONG> on error.
33 The function <STRONG>item_count</STRONG> returns <STRONG>ERR</STRONG> (the general <STRONG>curses</STRONG>
34 error return value) on error.
36 The function <STRONG>set_menu_items</STRONG> returns one of the following
39 <STRONG>E_OK</STRONG> The routine succeeded.
41 <STRONG>E_SYSTEM_ERROR</STRONG>
42 System error occurred (see <STRONG>errno</STRONG>).
44 <STRONG>E_BAD_ARGUMENT</STRONG>
45 Routine detected an incorrect or out-of-range argu-
48 <STRONG>E_POSTED</STRONG>
49 The menu is already posted.
51 <STRONG>E_NOT_CONNECTED</STRONG>
52 No items are connected to the menu.
56 <H2>SEE ALSO</H2><PRE>
57 <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="menu.3x.html">menu(3X)</A></STRONG>.
62 The header file <STRONG><menu.h></STRONG> automatically includes the header
63 file <STRONG><curses.h></STRONG>.
67 <H2>PORTABILITY</H2><PRE>
69 The SVr4 menu library documentation specifies the
70 <STRONG>item_count</STRONG> error value as -1 (which is the value of <STRONG>ERR</STRONG>).
75 Juergen Pfeifer. Manual pages and adaptation for new
76 curses by Eric S. Raymond.