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 7.1