NAME
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
Curses Menu Library (libmenu, -lmenu)
SYNOPSIS
#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
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 its description. The value of the pad
character is set by the
set_menu_pad() function.
RETURN VALUES
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 initialization 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 recognize 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
curses(3),
menus(3)
NOTES
The header
<menu.h> automatically includes both
<curses.h> and
<eti.h>.