menuspacing(3X) menuspacing(3X)
NAME
menuspacing - Control spacing between menu items.
SYNOPSIS
##include <>
int setmenuspacing(MENU *menu,
int spcdescription,
int spcrows,
int spccolumns);
int menuspacing(const MENU *menu,
int* spcdescription,
int* spcrows,
int* spccolumns);
DESCRIPTION
The function setmenuspacing sets the spacing informations for the
menu. spcdescription controls the number of spaces between an item
name and an item description. It must not be larger than TABSIZE. The
menu system puts in the middle of this spacing area the pad character.
The remaining parts are filled with spaces. spcrows controls the num-
ber of rows that are used for an item. It must not be larger than 3.
The menu system inserts then blank lines between item rows, these lines
will contain the pad character in the appropriate positions. spccol-
umns controls the number of blanks between columns of items. It must
not be larger than TABSIZE. A value of 0 for all the spacing values
resets them to the default, which is 1 for all of them.
The function menuspacing passes back the spacing info for the menu. If
a pointer is NUL, this specific info is simply not returned.
RETURN VALUE
Both routines return EOK on success. setmenuspacing may return
EPOSTED if the menu is posted, or EBADARGUMENT if one of the spacing
values is out of range.
SEE ALSO
curses(3X), menu(3X).
NOTES
The header file <> automatically includes the header file
<>.
PORTABILITY
These routines are specific to ncurses. They were not supported on
Version 7, BSD or System V implementations. It is recommended that any
code depending on them be conditioned using NCURSESVERSION.
AUTHORS
Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S.
Raymond.
menuspacing(3X)
|