MENU_OPTS(3CURSES) Curses Library Functions MENU_OPTS(3CURSES)

NAME

menu_opts, set_menu_opts, menu_opts_on, menu_opts_off - menus option
routines

SYNOPSIS

cc [ flag... ] file... -lmenu -lcurses [ library... ]
#include <menu.h>

OPTIONS menu_opts(MENU *menu);


int set_menu_opts(MENU *menu, OPTIONS opts);


int menu_opts_on(MENU *menu, OPTIONS opts);


int menu_opts_off(MENU *menu, OPTIONS opts);

DESCRIPTION

Menu Options

set_menu_opts() turns on the named options for menu and turns off all
other options. Options are boolean values that can be OR-ed together.


menu_opts_on() turns on the named options for menu; no other option
is changed.


menu_opts_off() turns off the named options for menu; no other option
is changed.


menu_opts() returns the current options of menu.


The following values can be OR'd together to create opts.

O_ONEVALUE
Only one item can be selected from the menu.


O_SHOWDESC
Display the description of the items.


O_ROWMAJOR
Display the menu in row major order.


O_IGNORECASE
Ignore the case when pattern matching.


O_SHOWMATCH
Place the cursor within the item name when pattern
matching.


O_NONCYCLIC
Make certain menu driver requests non-cyclic.

RETURN VALUES

Except for menu_opts(), these routines return one of the following:

E_OK
The routine returned successfully.


E_SYSTEM_ERROR
System error.


E_POSTED
The menu is already posted.

ATTRIBUTES

See attributes(7) for descriptions of the following attributes:


+---------------+-----------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-----------------+
|MT-Level | Unsafe |
+---------------+-----------------+

SEE ALSO

curses(3CURSES), menus(3CURSES), attributes(7)

NOTES

The header <menu.h> automatically includes the headers <eti.h> and
<curses.h>.

December 31, 1996 MENU_OPTS(3CURSES)