menu_mark(3) [netbsd man page]

MENU_MARK(3)						   BSD Library Functions Manual 					      MENU_MARK(3)

NAME

     menu_mark, menu_unmark, set_menu_mark, set_menu_unmark -- get or set strings that show mark status for a menu

LIBRARY

     Curses Menu Library (libmenu, -lmenu)

SYNOPSIS

     #include <menu.h>

     char *
     menu_mark(MENU *menu);

     char *
     menu_unmark(MENU *menu);

     int
     set_menu_mark(MENU *menu, char *mark);

     int
     set_menu_unmark(MENU *menu, char *mark);

DESCRIPTION

     The menu_mark() function returns a pointer to the character string that is used to mark selected items in the menu.  The mark string is set
     by the set_menu_mark() function.  The menu_unmark() function returns a pointer to the character string that is used to indicate a menu items
     is not selected, this string is set by the set_menu_unmark() function.  The mark and unmark strings may be of differing lengths, the room
     allocated to drawing the mark will be the maximum of the lengths of both the mark and unmark strings.  The shorter of the two strings will be
     left justified and space padded.

RETURN VALUES

     The functions return one of the following error values:

     E_OK		The function was successful.
     E_SYSTEM_ERROR	There was a system error during the call.
     E_BAD_ARGUMENT	One or more of the arguments passed to the function was incorrect.
     E_POSTED		The menu is already posted.
     E_CONNECTED	An item was already connected to a menu.
     E_BAD_STATE	The function was called from within an initialization or termination routine.
     E_NO_ROOM		The menu does not fit within the subwindow.
     E_NOT_POSTED	The menu is not posted.
     E_UNKNOWN_COMMAND	The menu driver does not recognize the request passed to it.
     E_NO_MATCH 	The character search failed to find a match.
     E_NOT_SELECTABLE	The item could not be selected.
     E_NOT_CONNECTED	The item is not connected to a menu.
     E_REQUEST_DENIED	The menu driver could not process the request.

SEE ALSO

     curses(3), menus(3)

NOTES

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

BSD
								September 10, 1999							       BSD

Check Out this Related Man Page

menu_mark(3X)															     menu_mark(3X)

NAME

       menu_mark - get and set the menu mark string

SYNOPSIS

       #include <menu.h>
       int set_menu_mark(MENU *menu, const char *mark);
       const char *menu_mark(const MENU *menu);

DESCRIPTION

       In order to make menu selections visible on older terminals without highlighting or color capability, the menu library marks selected items
       in a menu with a prefix string.

       The function set_menu_mark sets the mark string for the given menu.  Calling set_menu_mark with a null menu  item  will	abolish  the  mark
       string.	Note that changing the length of the mark string for a menu while the menu is posted is likely to produce unhelpful behavior.

       The default string is "-" (a dash). Calling set_menu_mark with a non-NULL menu argument will change this default.

       The function menu_mark returns the menu's mark string (or NULL if there is none).

RETURN VALUE

       The function menu_mark returns a pointer (which may be NULL).  It does not set errno.

       The function set_menu_mark may return the following error codes:

       E_OK The routine succeeded.

       E_BAD_ARGUMENT
	    Routine detected an incorrect or out-of-range argument.

       E_SYSTEM_ERROR
	    System error occurred (see errno).

SEE ALSO

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

NOTES

       The header file <menu.h> automatically includes the header file <curses.h>.

PORTABILITY

       These routines emulate the System V menu library.  They were not supported on Version 7 or BSD versions.

AUTHORS

       Juergen Pfeifer.  Manual pages and adaptation for new curses by Eric S. Raymond.

																     menu_mark(3X)

Linux and UNIX Man Pages

menu_mark(3) [netbsd man page]

Check Out this Related Man Page