menu_pad3
Color and attribute control for menus
Part of menu_attributes(3).
Usage
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);
Overview
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(3)).
E_BAD_ARGUMENT-
Routine detected an incorrect or out-of-range argument.
Portability
These routines emulate the System V menu library. They were not supported on Version 7 or BSD versions.
History
- FreeBSD 16.0-CURRENT (2026-10-27) to FreeBSD 14.2-RELEASE: the text shown here
- FreeBSD 14.1-RELEASE to FreeBSD 14.0-RELEASE
- FreeBSD 13.5-RELEASE to FreeBSD 13.0-RELEASE
- FreeBSD 12.4-RELEASE to FreeBSD 11.0-RELEASE
- FreeBSD 10.4-RELEASE to FreeBSD 8.0-RELEASE
- FreeBSD 7.4-RELEASE to FreeBSD 6.3-RELEASE
- FreeBSD 6.2-RELEASE to FreeBSD 5.0-RELEASE
- FreeBSD 4.11-RELEASE to FreeBSD 4.3-RELEASE