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

MENU (3T) (AT&T UNIX PC only ) MENU (3T)
M_lbuf is an array of characters which is used to assemble typed
input. It is always returned to the caller in case it is necessary to
record keystrokes. In addition, the user may enter keystroke data
which does not match any items. In this case m_selcnt is set to
zero on return.
M_win holds the window identifier associated with this menu. It
is allocated on an M_BEGIN call, used on subsequent calls, and
deleted on an M_END call. M_track is a pointer to the mousetracking
information required during menu interaction. The space
for this data is allocated on M_BEGIN and freed on M_END.
The caller should not use m_track, m_oldwidth, or m_oldheight.
They may be left un-initialized on call to M_BEGIN. If a value
must be given (as in a mitem_t initializer), a value of zero should
be used.
On return, m_selcnt contains a count of the number of selected
items.
M_items points to the array of menu items (see below). M_ curi
points to the current item. The caller should point m_curi to the
default item. Menu will modify m_curi as the user moves the
highlighting around in the menu. The list of menu items is terminated
by an item whose mi_name is NULL. M_topi contains a
pointer to the item which is at the top of the display. As the window
scrolls through the menu, m_topi changes to reflect the new
position of the view. The caller needn't initialize m_topi as menu
will compute a "good" initial view from the value in m_curi. In
general, callers will not read the value in m_topi and should never
write it.
Each item in the array pointed to by m_items and m_curi has
the following form:
typedef struct
{
char
char
int
} mitem_t;
*mi_name;
mi_flags;
mi_val;
/* name of item * /
/* flags * /
/* user-supplied value * /
Mi_name is the item name, mi_ftags contains the M_MARKED
flag which indicates that this item should be marked (on call)
and/or was marked (on return) and/or the M_DIMMED flag
which indicates that this item should be displayed in lowerintensity.
Mi_val is unused by menu and is available for
application-specific data. Often, mi_val contains a small positive
integer identifying the particular choice.
EXAMPLE
The following program illustrates a simple single-selection menu:
#include
#include
#include
#include
- 3-