menu_post(S-osr5)

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

Syntax

cc ... -lmenu -lcurses

#include <menu.h>

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

Description

post_menu- write the menu to its subwindow

unpost_menu- remove the menu from its subwindow

post_menu(S-osr5) writes menu to the subwindow. You must use curses(S-osr5) library routines to display the menu on the physical screen or call update_panels(S-osr5) if the panels(S-osr5) library is being used.

unpost_menu(S-osr5) erases menu from its associated subwindow.

Return values

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.

Warning

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

Files

/usr/lib/libmenu.a: the library

Standards conformance

post_menu(S-osr5) and unpost_menu(S-osr5) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.

`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.