menu_win(S)

menu_win: set_menu_win, menu_win, set_menu_sub, menu_sub, scale_menu -- menus window and subwindow association routines

Syntax

cc ... -lmenu -lcurses

#include <menu.h>

int set_menu_win(MENU *menu, WINDOW *win);
WINDOW *menu_win(MENU **menu);
int set_menu_sub(MENU *menu, WINDOW *sub);
WINDOW *menu_sub(MENU *menu);
int scale_menu(MENU *menu, int *rows, int *cols);

Description

set_menu_win- set the window for a specified menu

menu_win- return the window for a specified menu

set_menu_sub- set the subwindow for a specified menu

menu_sub- return the subwindow for a specified menu

scale_menu- returns the minimum size needed by the subwindow of a menu

set_menu_win(S) sets the window of menu to win. menu_win(S) returns a pointer to the window of menu.

set_menu_sub(S) sets the subwindow of menu to sub. menu_sub(S) returns a pointer to the subwindow of menu.

scale_menu(S) returns the minimum window size necessary for the subwindow of menu. rows and cols are pointers to the locations used to return the values.

Return values

Routines that return pointers always return NULL on error. Routines that return an integer return 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.

E_NOT_CONNECTED - No items are connected to the menu.

Warning

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

Files

/usr/lib/libmenu.a: the library

Standards conformance

set_menu_win(S), menu_win(S), set_menu_sub(S), menu_sub(S), and scale_menu(S) are not part of any currently supported standard; they were developed by UNIX System Laboratories, Inc. and are maintained by The SCO Group.

`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.