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

MENU (3T) (AT&T UNIX PC only ) MENU (3T)
mitem_t *m_topi;
} menu_t;
j* item at top of dpy * /
M_label is displayed in the menu's window label line. If m_label
is NULL, no label is displayed.
M_title is a title for the menu. If m_title is NULL, the menu is
displayed without any title. If m_title contains newline characters,
all but the first line of the title are underlined.
M_prompt (when non-NULL) is an prompt for the menu. All
prompts are displayed on the system prompt line, generally
located at the bottom of the display.
M_rows and m_cols allow the caller to specify the number of
rows and columns of items. Either or both of these values may be
zero, in which case menu will try to pick "good" values. It is
quite common to specify "zero" rows and one column to force output
to be vertical. When both m_rows and m_cols are zero,
menu tries to fit the menu into an appealing rectangle.
M_iwidth specifies a maximum width for each item. If m_iwidth
is zero, menu will display as much of the item as possible given
the available window real-estate. If m_iwidth is non-zero, items
are automatically truncated to that width, regardless of other
parameters. This is very useful when generating multi-column
menus where the caller wishes to prevent one long item from disrupting
the columnar output. M_IWIDTH IS NOT YET IMPLE- ·1
MENTED.
M_iheight allows the caller to specify the number of rows per item
on the display. Newline characters in the item's name cause
menu to advance to the next row. If m_iheight is zero, one-row
items are assumed. M_IHEIGHT IS NOT YET IMPLEMENTED.
M_ft ags contains the M_SINGLE flag which prohibits the user
from selecting more than one item from the menu. If the
M_SINGLE flag is off, the user may select multiple items from the
menu. The M_USEWIN flag, if set, will cause menu to use the
window supplied in m_win instead of creating its own. If
M_USEWIN is set, M_BEGIN operations will re-size the window
(as necessary) and M_END operations do not delete the window.
The M_WINNEW flag causes menu to use the "new " algorithm
to place the window. Basically, the new algorithm looks for relatively
empty screen space to place the window. M_ WINSON
causes menu to use the "son" algorithm which causes the new
window to slightly overlap the current window. If neither
M_WINNEW nor M_WINSON is given, the "popup" algorithm is
used. This causes the new window to appear near the middle of �
the current window, inside it if possible. The M_NOMOVE,
M_NOHELP, and M_NORESIZE flags, if set, prevent the Move,
Help and Resize icons, respectively, from being displayed on the
menu border. The M....ASISTITLE flag, if set, causes the menu
title to be displayed as supplied by the user, i.e., without centering.
- 2-