ncurses 4.2
[ncurses.git] / Ada95 / html / man / menu_attribs.3x.html
1 <HTML>
2 <BODY>
3 <PRE>
4        <STRONG>menu_attributes</STRONG> - color and attribute control for menus
5
6
7 </PRE>
8 <H2>SYNOPSIS</H2><PRE>
9        <STRONG>#include</STRONG> <STRONG><menu.h></STRONG>
10        int set_menu_fore(MENU *menu, chtype attr);
11        chtype menu_fore(const MENU *menu);
12        int set_menu_back(MENU *menu, chtype attr);
13        chtype menu_back(const MENU *menu);
14        int set_menu_grey(MENU *menu, chtype attr);
15        chtype menu_grey(const MENU *menu);
16        int set_menu_pad(MENU *menu, int pad);
17        int menu_pad(const MENU *menu);
18
19
20 </PRE>
21 <H2>DESCRIPTION</H2><PRE>
22        The  function  <STRONG>set_menu_fore</STRONG> sets the foreground attribute
23        of <EM>menu</EM>. This is the  highlight  used  for  selected  menu
24        items.   <STRONG>menu_fore</STRONG>  returns the foreground attribute.  The
25        default is <STRONG>A_STANDOUT</STRONG>.
26
27        The function <STRONG>set_menu_back</STRONG> sets the  background  attribute
28        of  <EM>menu</EM>.  This  is the highlight used for selectable (but
29        not  currently  selected)  menu   items.    The   function
30        <STRONG>menu_back</STRONG>  returns  the background attribute.  The default
31        is <STRONG>A_NORMAL</STRONG>.
32
33        The function <STRONG>set_menu_grey</STRONG>  sets  the  grey  attribute  of
34        <EM>menu</EM>.  This  is  the highlight used for un-selectable menu
35        items in menus that permit more than one  selection.   The
36        function   <STRONG>menu_grey</STRONG>  returns  the  grey  attribute.   The
37        default is <STRONG>A_UNDERLINE</STRONG>.
38
39        The function <STRONG>set_menu_pad</STRONG> sets the character used to  fill
40        the space between the name and description parts of a menu
41        item.  <STRONG>menu_pad</STRONG> returns the given  menu's  pad  character.
42        The default is a blank.
43
44
45 </PRE>
46 <H2>RETURN VALUE</H2><PRE>
47        These routines return one of the following:
48
49        <STRONG>E_OK</STRONG> The routine succeeded.
50
51        <STRONG>E_SYSTEM_ERROR</STRONG>
52             System error occurred (see <STRONG>errno</STRONG>).
53
54        <STRONG>E_BAD_ARGUMENT</STRONG>
55             Routine  detected  an incorrect or out-of-range argu-
56             ment.
57
58
59 </PRE>
60 <H2>SEE ALSO</H2><PRE>
61        <STRONG><A HREF="ncurses.3x.html">curses(3X)</A></STRONG> and 3X pages  whose  names  begin  "menu_"  for
62        detailed descriptions of the entry points.
63
64        The header file <STRONG><menu.h></STRONG> automatically includes the header
65        file <STRONG><curses.h></STRONG>.
66
67
68 </PRE>
69 <H2>PORTABILITY</H2><PRE>
70        These routines emulate the System V  menu  library.   They
71        were not supported on Version 7 or BSD versions.
72
73
74 </PRE>
75 <H2>AUTHORS</H2><PRE>
76        Juergen  Pfeifer.   Manual  pages  and  adaptation for new
77        curses by Eric S. Raymond.
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120 </PRE>
121 </BODY>
122 </HTML>