MENU_FORMAT(3CURSES) Curses Library Functions MENU_FORMAT(3CURSES)

NAME

menu_format, set_menu_format - set and get maximum numbers of rows
and columns in menus

SYNOPSIS

cc [ flag... ] file... -lmenu -lcurses [ library... ]
#include <menu.h>

int set_menu_format(MENU *menu, int rows, int cols);


void menu_format(MENU *menu, int *rows, int *cols);

DESCRIPTION

set_menu_format() sets the maximum number of rows and columns of
items that may be displayed at one time on a menu. If the menu
contains more items than can be displayed at once, the menu will be
scrollable.


menu_format() returns the maximum number of rows and columns that may
be displayed at one time on menu. rows and cols are pointers to the
variables used to return these values.

RETURN VALUES

set_menu_format() returns one of the following:

E_OK
The routine returned successfully.


E_SYSTEM_ERROR
System error.


E_BAD_ARGUMENT
An incorrect argument was passed to the routine.


E_POSTED
The menu is already posted.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+

SEE ALSO

curses(3CURSES), menus(3CURSES), attributes(7)

NOTES

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

December 31, 1996 MENU_FORMAT(3CURSES)