Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

menu_win(3) [netbsd man page]

MENU_WIN(3)						   BSD Library Functions Manual 					       MENU_WIN(3)

menu_sub, menu_win, scale_menu, set_menu_sub, set_menu_win -- sub-menu handling LIBRARY
Curses Menu Library (libmenu, -lmenu) SYNOPSIS
#include <menu.h> WINDOW * menu_sub(MENU *menu); WINDOW * menu_win(MENU *menu); int scale_menu(MENU *menu, int *rows, int *cols); int set_menu_sub(MENU *menu, WINDOW *sub); int set_menu_win(MENU *menu, WINDOW *win); DESCRIPTION
The menu_sub() function returns a pointer to the window that will be used to post a menu into, this pointer is set by the set_menu_sub() function. The menu_win() function returns a pointer to the window in which the menu subwindow will be created when the menu is posted, this pointer is set by the set_menu_win() function. The scale_menu() function calculates the minimum size a window needs to be to hold the items for a given menu, the parameters rows and cols are set to the required number of rows and columns respectively. RETURN VALUES
The functions return one of the following error values: E_OK The function was successful. E_SYSTEM_ERROR There was a system error during the call. E_BAD_ARGUMENT One or more of the arguments passed to the function was incorrect. E_POSTED The menu is already posted. E_CONNECTED An item was already connected to a menu. E_BAD_STATE The function was called from within an initialization or termination routine. E_NO_ROOM The menu does not fit within the subwindow. E_NOT_POSTED The menu is not posted E_UNKNOWN_COMMAND The menu driver does not recognize the request passed to it. E_NO_MATCH The character search failed to find a match. E_NOT_SELECTABLE The item could not be selected. E_NOT_CONNECTED The item is not connected to a menu. E_REQUEST_DENIED The menu driver could not process the request. SEE ALSO
curses(3), menus(3) NOTES
The header <menu.h> automatically includes both <curses.h> and <eti.h>. BSD
September 10, 1999 BSD

Check Out this Related Man Page

menu_win(3CURSES)					     Curses Library Functions						 menu_win(3CURSES)

menu_win, set_menu_win, set_menu_sub, menu_sub, scale_menu - menus window and subwindow association routines SYNOPSIS
cc [ flag... ] file... -lmenu -lcurses [ library... ] #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_window(MENU *menu, int *rows, int *cols); DESCRIPTION
set_menu_win() sets the window of menu to win. menu_win() returns a pointer to the window of menu.set_menu_sub() sets the subwindow of menu to sub. menu_sub() returns a pointer to the subwindow of menu.scale_window() 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. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |MT-Level |Unsafe | +-----------------------------+-----------------------------+ SEE ALSO
curses(3CURSES), menus(3CURSES), attributes(5) NOTES
The header <menu.h> automatically includes the headers <eti.h> and <curses.h>. SunOS 5.10 31 Dec 1996 menu_win(3CURSES)
Man Page