NAME    [Toc]    [Back]

     menu_back, menu_fore, menu_grey, menu_pad, set_menu_back, set_menu_fore,
     set_menu_grey, set_menu_pad - get and set menu attributes

LIBRARY    [Toc]    [Back]

     Curses Menu Library (libmenu, -lmenu)

SYNOPSIS    [Toc]    [Back]

     #include <menu.h>

     char
     menu_back(MENU *menu);

     char
     menu_fore(MENU *menu);

     char
     menu_grey(MENU *menu);

     int
     menu_pad(MENU *menu);

     int
     set_menu_back(MENU *menu, char attr);

     int
     set_menu_fore(MENU *menu, char attr);

     int
     set_menu_grey(MENU *menu, char attr);

     int
     set_menu_pad(MENU *menu, int pad);

DESCRIPTION    [Toc]    [Back]

     The menu_back() function returns the value of the background attribute
     for the menu passed.  This attribute is set by the set_menu_back() call.
     The menu_fore() function returns the value of the foreground character
     attribute for the menu passed.  This attribute is set by the
     set_menu_fore() function.  The menu_grey() function returns the value of
     the grey or unselectable character attribute for the menu passed.  This
     attribute is set by the set_menu_grey() function.  The menu_pad() function
 returns the padding character that will be used between the item
     name and it's description.  The value of the pad character is set by the
     set_menu_pad() function.

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