MENU_ATTRIBUTES(3) |
Library Functions Manual |
MENU_ATTRIBUTES(3) |
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.
NOTES
The header <menu.h> automatically includes both <curses.h> and <eti.h>.