menuopts(3X) menuopts(3X)

NAME
       mmeennuuooppttss - set and get menu options

SYNOPSIS
       ##iinncclluuddee <>
       int setmenuopts(MENU *menu, OPTIONS opts);
       int menuoptson(MENU *menu, OPTIONS opts);
       int menuoptsoff(MENU *menu, OPTIONS opts);
       OPTIONS menuopts(const MENU *menu);

DESCRIPTION
       The  function sseettmmeennuuooppttss sets all the given menu's option bits (menu
       option bits may be logically-OR'ed together).

       The function mmeennuuooppttssoonn turns on the given option  bits,  and  leaves
       others alone.

       The  function mmeennuuooppttssooffff turns off the given option bits, and leaves
       others alone.

       The function mmeennuuooppttss returns the menu's current option bits.

       The following options are defined (all are on by default):

       OONEVALUE
            Only one item can be selected for this menu.

       OSHOWDESC
            Display the item descriptions when the menu is posted.

       OROWMAJOR
            Display the menu in row-major order.

       OIGNORECASE
            Ignore the case when pattern-matching.

       OSHOWMATCH
            Move the cursor to within the item name while pattern-matching.

       ONONCYCLIC
            Don't wrap around next-item and  previous-item,  requests  to  the
            other end of the menu.

RREETTUURRNN VVAALLUUEE
       Except for mmeennuuooppttss, each routine returns one of the following:

       EEOOKK The routine succeeded.

       EESSYYSSTTEEMMEERRRROORR
            System error occurred (see eerrrrnnoo).

       EEPPOOSSTTEEDD
            The menu is already posted.

SEE ALSO
       ccuurrsseess(3X), mmeennuu(3X).

NNOOTTEESS
       The  header  file  <>  automatically  includes  the  header  file
       <>.

PPOORRTTAABBIILLIITTYY
       These routines emulate the System V menu 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.



                                                                 menuopts(3X)