menu_driver(3CURSES)					     Curses Library Functions					      menu_driver(3CURSES)

NAME

       menu_driver - command processor for the menus subsystem

SYNOPSIS

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

       int menu_driver(MENU *menu, int c);

DESCRIPTION

       menu_driver()  is the workhorse of the menus subsystem. It checks to determine whether the character c is a menu request or data. If c is a
       request, the menu driver executes the request and reports the result. If c is data (a printable ASCII character), it enters the	data  into
       the  pattern buffer and tries to find a matching item. If no match is found, the menu driver deletes  the character from the pattern buffer
       and returns E_NO_MATCH. If the character is not recognized, the menu driver assumes  it	is  an	application-defined  command  and  returns
       E_UNKNOWN_COMMAND.

       Menu driver requests:

       REQ_LEFT_ITEM	       Move left to an item.

       REQ_RIGHT_ITEM	       Move right to an item

       REQ_UP_ITEM	       Move up to an item.

       REQ_DOWN_ITEM	       Move down to an item.

       REQ_SCR_ULINE	       Scroll up a line.

       REQ_SCR_DLINE	       Scroll down a line.

       REQ_SCR_DPAGE	       Scroll up a page.

       REQ_SCR_UPAGE	       Scroll down a page.

       REQ_FIRST_ITEM	       Move to the first item.

       REQ_LAST_ITEM	       Move to the last item.

       REQ_NEXT_ITEM	       Move to the next item.

       REQ_PREV_ITEM	       Move to the previous item.

       REQ_TOGGLE_ITEM	       Select/de-select an item.

       REQ_CLEAR_PATTERN       Clear the menu pattern buffer.

       REQ_BACK_PATTERN        Delete the previous character from pattern buffer.

       REQ_NEXT_MATCH	       Move the next matching item.

       REQ_PREV_MATCH	       Move to the previous matching item.

RETURN VALUES

       menu_driver() returns one of the following:

       E_OK		       The routine returned successfully.

       E_SYSTEM_ERROR	       System error.

       E_BAD_ARGUMENT	       An incorrect argument was passed to the routine.

       E_BAD_STATE	       The routine was called from an initialization or termination function.

       E_NOT_POSTED	       The menu has not been posted.

       E_UNKNOWN_COMMAND       An unknown request was passed to the menu driver.

       E_NO_MATCH	       The character failed to match.

       E_NOT_SELECTABLE        The item cannot be selected.

       E_REQUEST_DENIED        The menu driver could not process the request.

ATTRIBUTES

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

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

SEE ALSO

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

NOTES

       Application-defined commands should be defined relative to (greater than) MAX_COMMAND, the maximum value of a request listed above.

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

SunOS 5.10							    31 Dec 1996 					      menu_driver(3CURSES)