'\"!  tbl | mmdoc
'\"macro stdmacro
.if n .pH g3x.menu_format @(#)menu_format	40.3 of 12/15/89
.\" Copyright 1989 AT&T
.\" ident	"@(#)svid_ti:ti_lib/menu_format	1.3"
.nr X
.if \nX=0 .ds x} menu_format 3X "" "\&"
.if \nX=1 .ds x} menu_format 3X ""
.if \nX=2 .ds x} menu_format 3X "" "\&"
.if \nX=3 .ds x} menu_format "" "" "\&"
.TH \*(x}
.SH NAME
\f4menu_format\f2: \f4 set_menu_format\f1, \f4menu_format\f1 \- set and get maximum numbers of rows and columns in \f4menus\fP
.SH SYNOPSIS
.nf
.ft 4
#include <menu.h>
.sp
int set_menu_format(MENU *menu, int rows, int cols);
.sp 0.5
void menu_format(MENU *menu, int *rows, int *cols);
.ft 1
.fi
.SH DESCRIPTION
\f4set_menu_format\fP 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.
.PP
\f4menu_format\fP returns the maximum number of rows and columns that
may be displayed at one time on \f2menu\f1.
\f2rows\f1 and \f2cols\f1 are pointers
to the variables used to return these values.
.SH RETURN VALUE
\f4set_menu_format\fP returns one of the following:
.TS
lfCWw(1.25i)1 c1 l .
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.
.TE
.RE
.SH NOTES
.PP
The header file \f4<menu.h>\f1 automatically includes the header files
\f4<eti.h>\fP and \f4<curses.h>\fP.
.SH SEE ALSO
.na
\f4curses\fP(3X),
\f4menus\fP(3X).
.ad
