4 <STRONG>menu_mark</STRONG> - get and set the menu mark string
9 <STRONG>#include</STRONG> <STRONG><menu.h></STRONG>
10 int set_menu_mark(MENU *menu, const char *mark);
11 const char *menu_mark(const MENU *menu);
15 <H2>DESCRIPTION</H2><PRE>
16 In order to make menu selections visible on older termi-
17 nals without highlighting or color capability, the menu
18 library marks selected items in a menu with a prefix
21 The function <STRONG>set_menu_mark</STRONG> sets the mark string for the
22 given menu. Calling <STRONG>set_menu_mark</STRONG> with a null menu item
23 will abolish the mark string. Note that changing the
24 length of the mark string for a menu while the menu is
25 posted is likely to produce unhelpful behavior.
27 The default string is "-" (a dash). Calling <STRONG>set_menu_mark</STRONG>
28 with a <STRONG>NULL</STRONG> menu argument will change this default.
30 The function <STRONG>menu_mark</STRONG> returns the menu's mark string (or
31 <STRONG>NULL</STRONG> if there is none).
35 <H2>RETURN VALUE</H2><PRE>
36 The function <STRONG>menu_mark</STRONG> returns <STRONG>NULL</STRONG> on error. The func-
37 tion <STRONG>set_menu_mark</STRONG> may return the following error codes:
39 <STRONG>E_OK</STRONG> The routine succeeded.
41 <STRONG>E_SYSTEM_ERROR</STRONG>
42 System error occurred (see <STRONG>errno</STRONG>).
44 <STRONG>E_BAD_ARGUMENT</STRONG>
45 Routine detected an incorrect or out-of-range argu-
50 <H2>SEE ALSO</H2><PRE>
51 <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG>, <STRONG><A HREF="menu.3x.html">menu(3X)</A></STRONG>.
56 The header file <STRONG><menu.h></STRONG> automatically includes the header
57 file <STRONG><curses.h></STRONG>.
61 <H2>PORTABILITY</H2><PRE>
62 These routines emulate the System V menu library. They
63 were not supported on Version 7 or BSD versions.
68 Juergen Pfeifer. Manual pages and adaptation for new
69 curses by Eric S. Raymond.