menu_format(3X) menu_format(3X) NAME menu_format - set(7,n,1 builtins) and get menu(3x,n,n tk_menuSetFocus) sizes SYNOPSIS #include <menu.h> int set_menu_format(MENU *menu(3x,n,n tk_menuSetFocus), int rows, int cols); void menu_format(const MENU *menu(3x,n,n tk_menuSetFocus), int *rows, int *cols); DESCRIPTION The function set_menu_format sets the maximum display size of the given menu. If this size is too small to display all menu(3x,n,n tk_menuSetFocus) items, the menu(3x,n,n tk_menuSetFocus) will be made scrollable. If this size is larger than the menus subwin- dow and the subwindow is too small to display all menu(3x,n,n tk_menuSetFocus) items, post_menu() will fail. The default format is 16 rows, 1 column. Calling set_menu_format with a null menu(3x,n,n tk_menuSetFocus) pointer will change this default. A zero row or column argument to set_menu_format is interpreted as a request not to change the current value. The function menu_format returns the maximum-size constraints for the given menu(3x,n,n tk_menuSetFocus) into the storage addressed by rows and cols. RETURN VALUE These routines returns one of the following: E_OK The routine succeeded. E_SYSTEM_ERROR System error(8,n) occurred (see errno). E_BAD_ARGUMENT Routine detected an incorrect or out-of-range argument. E_POSTED The menu(3x,n,n tk_menuSetFocus) is already posted. SEE ALSO curses(3X), menu(3x,n,n tk_menuSetFocus)(3X). NOTES The header file(1,n) <menu.h> automatically includes the header file(1,n) <curses.h>. PORTABILITY These routines emulate the System V menu(3x,n,n tk_menuSetFocus) library. They were not sup- ported on Version 7 or BSD versions. AUTHORS Juergen Pfeifer. Manual pages and adaptation for new curses by Eric S. Raymond. menu_format(3X)