ncurses 4.1
[ncurses.git] / Ada95 / html / dft_fgbg.3x.html
1 <HTML>
2 <BODY BGCOLOR="#99ccbb" TEXT="#000000" LINK="#4060b0" VLINK="#000080" ALINK="#ff4040">
3 <PRE>
4        <STRONG>use_default_colors</STRONG> - use terminal's default colors
5
6
7 </PRE>
8 <H2>SYNOPSIS</H2><PRE>
9        <STRONG>#include</STRONG> <STRONG>&lt;curses.h&gt;</STRONG>
10
11        <STRONG>int</STRONG> <STRONG>use_default_colors(void);</STRONG>
12
13
14 </PRE>
15 <H2>DESCRIPTION</H2><PRE>
16        This  is  an  extension to the curses library.  It is used
17        with terminals that support ISO 6429 color, or equivalent.
18        These terminals allow the application to reset color to an
19        unspecified default value (e.g., with SGR 39 or  SGR  49).
20        Because  they  are  designed to support this, their design
21        usually includes features to change the default foreground
22        or background colors so that they do not match the assump-
23        tion in XSI curses of white on black.
24
25        Applications that paint  a  colored  background  over  the
26        whole  screen  are  not adversely impacted by this type of
27        terminal design.  However, there are applications that are
28        designed to work with the default background.
29
30
31 </PRE>
32 <H2>RETURN VALUE</H2><PRE>
33        The  function  returns the integer <STRONG>ERR</STRONG> upon failure and <STRONG>OK</STRONG>
34        on success.  It will fail if either the terminal does  not
35        support  the  <EM>orig</EM><STRONG>_</STRONG><EM>pair</EM> or <EM>orig</EM><STRONG>_</STRONG><EM>colors</EM> capability.  If the
36        <EM>initialize</EM><STRONG>_</STRONG><EM>pair</EM> capability is found, this causes an  error
37        as well.
38
39
40 </PRE>
41 <H2>NOTES</H2><PRE>
42        Associated with this extension, the <STRONG><A HREF="init_pair.3x.html">init_pair(3x)</A></STRONG> function
43        accepts negative arguments to specify  default  foreground
44        or background colors.
45
46
47 </PRE>
48 <H2>PORTABILITY</H2><PRE>
49        These  routines  are  specific  to ncurses.  They were not
50        supported on Version 7, BSD or System  V  implementations.
51        It  is recommended that any code depending on them be con-
52        ditioned using NCURSES_VERSION.
53
54
55 </PRE>
56 <H2>SEE ALSO</H2><PRE>
57        <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>, <STRONG><A HREF="ded.1.html">ded(1)</A></STRONG>.
58
59
60 </PRE>
61 <H2>AUTHOR</H2><PRE>
62        Thomas Dickey (from an analysis of  the  requirements  for
63        color xterm for XFree86 3.1.2C, February 1996).
64
65
66
67
68
69
70 </PRE>
71 </BODY>
72 </HTML>