AT&T UNIX™PC Unix System V Users Manual - tenox

MENU (3T) {AT&T UNIX PC only ) MENU ( 3T )
NAME
menu - display and accept menus
SYNOPSIS
#include < menu.h >
int menu(menu, op)
menu_t *menu;
int op;
DESCRIPTION
This routine manipulates a menu as determined by the operation
code ( op ). If the op arg is M_BEGIN, the menu is initialized and
displayed. If op is M_INPUT, user input is accepted. If op is
M_END, the menu is terminated and removed from the display.
If op is M_DESEL, all currently-selected items are de-selected
before the menu is processed. These functions may be combined
in many ways. By specifying
(M_DESEL I M_BEGIN I M_INPUT I M_END), the caller creates
a "pop-up" menu which is initialized (displayed), used for input,
then removed. Generally, (M_BEGIN I M_INPUT) is used for the
first call, M_INPUT for each subsequent interaction, and M_END
when the menu is to be discarded. M_DESEL can be added to
clear bad choices after an error.
During the M_INPUT function, the user may point to items with
the mouse or with the keyboard (arrows, Prev, Next, Beg, Home,
End). The user may mark entries with the mouse or keyboard
(Sleet, Mark), or may qualify one or more items by typing. The
Cancl, Clear Line, Back Space, and Return keys perform their
generic editing functions. For larger menus, the Roll and Page
keys may be used to scroll through choices which do not fit in the
prevailing window.
All other keys, including Enter, are returned to the caller.
The menu structure has the following form:
typedef struct
{
char
char
char
char
char
char
char
char
char
int
track_t
int
int
int
mitem_t
mitem_t
*m_label;
*m_title;
*m_prompt;
m_rows;
m_cols;
m_iwidth;
m_iheight;
m_fiags;
m_lbuf[M_MAXLINE];
m_win;
*m_track;
m_oldwidth;
m_oldheight;
m_selcnt;
*m_items;
*m_curi;
- 1 -
/* menu label *I
/* menu title *I
/* menu prompt *I
/* desired rows *I
/* desired cols *I
/* item width *I
/* item height * I
I* flags * I
/* input buffer *I
/* window pointer *I
/* menu track list ptr *I
/* last window width *I
/* last window height *I
/* count of # selected *I
I* pointer to items *I
/* current item *I