NAME    [Toc]    [Back]

     menu_sub, menu_win, scale_window, set_menu_sub, set_menu_win - sub-menu
     handling

LIBRARY    [Toc]    [Back]

     Curses Menu Library (libmenu, -lmenu)

SYNOPSIS    [Toc]    [Back]

     #include <menu.h>

     WINDOW *
     menu_sub(MENU *menu);

     WINDOW *
     menu_win(MENU *menu);

     int
     scale_window(MENU *menu, int *rows, int *cols);

     int
     set_menu_sub(MENU *menu, WINDOW *sub);

     int
     set_menu_win(MENU *menu, WINDOW *win);

DESCRIPTION    [Toc]    [Back]

     The menu_sub() function returns a pointer to the window that will be used
     to post a menu into, this pointer is set by the set_menu_sub() function.
     The menu_win() function returns a pointer to the window in which the menu
     subwindow will be created when the menu is posted, this pointer is set by
     the set_menu_win() function.  The scale_window() function calculates the
     minimum size a window needs to be to hold the items for a given menu, the
     parameters rows and cols are set to the required number of rows and
     columns respectively.

RETURN VALUES    [Toc]    [Back]

     The functions return one of the following error values:

     E_OK               The function was successful.
     E_SYSTEM_ERROR     There was a system error during the call.
     E_BAD_ARGUMENT     One or more of the arguments passed to the function
                        was incorrect.
     E_POSTED           The menu is already posted.
     E_CONNECTED        An item was already connected to a menu.
     E_BAD_STATE        The function was called from within an initialisation
                        or termination routine.
     E_NO_ROOM          The menu does not fit within the subwindow.
     E_NOT_POSTED       The menu is not posted
     E_UNKNOWN_COMMAND  The menu driver does not recognise the request passed
                        to it.
     E_NO_MATCH         The character search failed to find a match.
     E_NOT_SELECTABLE   The item could not be selected.
     E_NOT_CONNECTED    The item is not connected to a menu.
     E_REQUEST_DENIED   The menu driver could not process the request.

SEE ALSO    [Toc]    [Back]

     curses(3), menus(3)

NOTES    [Toc]    [Back]

     The header <menu.h> automatically includes both <curses.h> and <eti.h>.

BSD                           September 10, 1999                           BSD