menupost(3X)                                                    menupost(3X)



NAME
       menupost - write or erase menus from associated subwindows

SYNOPSIS
       ##include <>
       int postmenu(MENU *menu);
       int unpostmenu(MENU *menu);

DESCRIPTION
       The function postmenu displays a menu to its associated subwindow.  To
       trigger physical display of the subwindow, use refresh or some  equiva-
       lent curses routine (the implicit doupdate triggered by an curses input
       request will do). postmenu resets the selection status of all items.

       The function unpostmenu erases menu from its associated subwindow.

RETURN VALUE
       These routines return one of the following:

       EOK The routine succeeded.

       ESYSTEMEROR
            System error occurred (see errno).

       EBADARGUMENT
            Routine detected an incorrect or out-of-range argument.

       EPOSTED
            The menu has already been posted.

       EBADSTATE
            Routine was called from an initialization or termination function.

       ENOROM
            Menu  is  too  large  for  its  window. You should consider to use
            setmenuformat() to solve the problem.

       ENOTPOSTED
            The menu has not been posted.

       ENOTCONECTED
            No items are connected to the menu.

SEE ALSO
       curses(3X), menu(3X).

NOTES
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PORTABILITY
       These  routines  emulate the System V menu library.  They were not sup-
       ported on Version 7 or BSD versions.

AUTHORS
       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S.
       Raymond.



                                                                 menupost(3X)