4 <STRONG>menu_post</STRONG> - write or erase menus from associated subwin-
10 <STRONG>#include</STRONG> <STRONG><menu.h></STRONG>
11 int post_menu(MENU *menu);
12 int unpost_menu(MENU *menu);
16 <H2>DESCRIPTION</H2><PRE>
17 The function <STRONG>post_menu</STRONG> displays a menu to its associated
18 subwindow. To trigger physical display of the subwindow,
19 use <STRONG>refresh</STRONG> or some equivalent <STRONG>curses</STRONG> routine (the
20 implicit <STRONG>doupdate</STRONG> triggered by an <STRONG>curses</STRONG> input request
21 will do). <STRONG>post_menu</STRONG> resets the selection status of all
24 The function <STRONG>unpost_menu</STRONG> erases menu from its associated
29 <H2>RETURN VALUE</H2><PRE>
30 These routines return one of the following:
32 <STRONG>E_OK</STRONG> The routine succeeded.
34 <STRONG>E_SYSTEM_ERROR</STRONG>
35 System error occurred (see <STRONG>errno</STRONG>).
37 <STRONG>E_BAD_ARGUMENT</STRONG>
38 Routine detected an incorrect or out-of-range argu-
41 <STRONG>E_POSTED</STRONG>
42 The menu has already been posted.
44 <STRONG>E_BAD_STATE</STRONG>
45 Routine was called from an initialization or termina-
48 <STRONG>E_NO_ROOM</STRONG>
49 Menu is too large for its window. You should consider
50 to use <STRONG>set_menu_format()</STRONG> to solve the problem.
52 <STRONG>E_NOT_POSTED</STRONG>
53 The menu has not been posted.
55 <STRONG>E_NOT_CONNECTED</STRONG>
56 No items are connected to the menu.
60 <H2>SEE ALSO</H2><PRE>
61 <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="menu.3x.html">menu(3X)</A></STRONG>.
69 <H2>PORTABILITY</H2><PRE>
70 These routines emulate the System V menu library. They
71 were not supported on Version 7 or BSD versions.
76 Juergen Pfeifer. Manual pages and adaptation for new
77 curses by Eric S. Raymond.