menu_attributes 3x

menu_attributes(3x)                                        menu_attributes(3x)




NAME

       menu_back,     menu_fore,     menu_grey,    menu_pad,    set_menu_back,
       set_menu_fore, set_menu_grey, set_menu_pad - color and  attribute  con-
       trol for menus


SYNOPSIS

       #include <menu.h>
       int set_menu_fore(MENU *menu, chtype attr);
       chtype menu_fore(const MENU *menu);
       int set_menu_back(MENU *menu, chtype attr);
       chtype menu_back(const MENU *menu);
       int set_menu_grey(MENU *menu, chtype attr);
       chtype menu_grey(const MENU *menu);
       int set_menu_pad(MENU *menu, int pad);
       int menu_pad(const MENU *menu);


DESCRIPTION

       The  function set_menu_fore sets the foreground attribute of menu. This
       is the highlight used for selected menu items.  menu_fore  returns  the
       foreground attribute.  The default is A_REVERSE.

       The  function set_menu_back sets the background attribute of menu. This
       is the highlight used for selectable (but not currently selected)  menu
       items.   The  function menu_back returns the background attribute.  The
       default is A_NORMAL.

       The function set_menu_grey sets the grey attribute of menu. This is the
       highlight  used  for un-selectable menu items in menus that permit more
       than one selection.  The function menu_grey returns the grey attribute.
       The default is A_UNDERLINE.

       The  function  set_menu_pad  sets  the character used to fill the space
       between the name and  description  parts  of  a  menu  item.   menu_pad
       returns the given menu's pad character.  The default is a blank.


RETURN VALUE

       These routines return one of the following:

       E_OK The routine succeeded.

       E_SYSTEM_ERROR
            System error occurred (see errno).

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


SEE ALSO

       curses(3x)  and  related  pages  whose names begin "menu_" for detailed
       descriptions of the entry points.


NOTES

       The  header  file  <menu.h>  automatically  includes  the  header  file
       <curses.h>.


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.



                                                           menu_attributes(3x)