menu_post(3ocurses)

menu_post: post_menu, unpost_menu -- write or erase menus from associated subwindows

Synopsis

cc [flag . . .] file -lmenu -locurses [library . . .]

#include <menu.h>

int post_menu(MENU menu);
int unpost_menu(MENU menu);

Description

post_menu writes menu to the subwindow. The application programmer must use curses library routines to display the menu on the physical screen or call update_panels if the panels library is being used.

unpost_menu erases menu from its associated subwindow.

<Return> value

These routines return one of the following:

E_OK - The routine returned successfully.

E_SYSTEM_ERROR - System error.

E_BAD_ARGUMENT - An incorrect argument was passed to the routine.

E_POSTED - The menu is already posted.

E_BAD_STATE - The routine was called from an initialization or termination function.

E_NO_ROOM - The menu does not fit within its subwindow.

E_NOT_POSTED - The menu has not been posted.

E_NOT_CONNECTED - No items are connected to the menu.

Notices

The header file menu.h automatically includes the header files eti.h and ocurses.h.

References

curses(3ocurses), menus(3ocurses), panels(3ocurses)

E_OK	-	The routine returned successfully.
E_SYSTEM_ERROR	-	System error.
E_BAD_ARGUMENT	-	An incorrect argument was passed to the routine.
E_POSTED	-	The menu is already posted.
E_BAD_STATE	-	The routine was called from an initialization or termination function.
E_NO_ROOM	-	The menu does not fit within its subwindow.
E_NOT_POSTED	-	The menu has not been posted.
E_NOT_CONNECTED	-	No items are connected to the menu.