menuopts(3X)                                                    menuopts(3X)



NAME
       menuopts - set and get menu options

SYNOPSIS
       ##include <>
       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 setmenuopts sets all the given menu's option bits (menu
       option bits may be logically-OR'ed together).

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

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

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

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

       ONEVALUE
            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.

RETURN VALUE
       Except for menuopts, each routine returns one of the following:

       EOK The routine succeeded.

       ESYSTEMEROR
            System error occurred (see errno).

       EPOSTED
            The menu is already posted.

SEE ALSO
       curses(3X), menu(3X).

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

PORTABILITY
       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)