MENU_ATTRIBUTES(3)

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.

# SEE ALSO

curses(3), menus(3)

# NOTES

The header <menu.h> automatically includes both <curses.h> and <eti.h>.

September 10, 1999 | NetBSD 10.0