'\"!  tbl | mmdoc
'\"macro stdmacro
.if n .pH g3x.menu_win @(#)menu_win	40.3 of 12/15/89
.\" Copyright 1989 AT&T
.\" ident	"@(#)svid_ti:ti_lib/menu_win	1.3"
.nr X
.if \nX=0 .ds x} menu_win 3X "" "\&"
.if \nX=1 .ds x} menu_win 3X ""
.if \nX=2 .ds x} menu_win 3X "" "\&"
.if \nX=3 .ds x} menu_win "" "" "\&"
.TH \*(x}
.SH NAME
\f4menu_win\f2: \f4 set_menu_win\f1, \f4menu_win\f1, \f4set_menu_sub\f1, \f4menu_sub\f1, \f4scale_menu\f1 \- \f4menus\fP window and subwindow association routines
.SH SYNOPSIS
.nf
.ft 4
#include <menu.h>
.sp
int set_menu_win(MENU *menu, WINDOW *win);
WINDOW *menu_win(MENU *menu);
.sp 0.5
int set_menu_sub(MENU *menu, WINDOW *sub);
WINDOW *menu_sub(MENU *menu);
.sp 0.5
int scale_window(MENU *menu, int *rows, int *cols);
.ft 1
.fi
.SH DESCRIPTION
\f4set_menu_win\fP sets the window of \f2menu\f1 to \f2win\f1.
\f4menu_win\fP returns a pointer to the window of \f2menu\f1.
.PP
\f4set_menu_sub\fP sets the subwindow of \f2menu\f1 to \f2sub\f1.
\f4menu_sub\fP returns a pointer to the subwindow of \f2menu\f1.
.PP
\f4scale_window\fP returns the minimum window size necessary for the
subwindow of \f2menu\f1.
\f2rows\f1 and \f2cols\f1 are pointers to the locations used to return the
values.
.SH RETURN VALUE
Routines that return pointers always return \f4NULL\fP on error.
Routines that return an integer return 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.
E_NOT_CONNECTED	\-	No items are connected to the menu.
.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
