<!--
* t
****************************************************************************
- * Copyright (c) 1998-2003,2005 Free Software Foundation, Inc. *
+ * Copyright (c) 1998-2009,2010 Free Software Foundation, Inc. *
* *
* Permission is hereby granted, free of charge, to any person obtaining a *
* copy of this software and associated documentation files (the *
* sale, use or other dealings in this Software without prior written *
* authorization. *
****************************************************************************
- * @Id: curs_attr.3x,v 1.29 2005/05/15 16:17:25 tom Exp @
+ * @Id: curs_attr.3x,v 1.36 2010/12/04 18:36:44 tom Exp @
-->
<HTML>
<HEAD>
color argument is a color-pair index (as in the first ar-
gument of <EM>init</EM><STRONG>_</STRONG><EM>pair</EM>, see <STRONG><A HREF="curs_color.3x.html">curs_color(3x)</A></STRONG>). The <STRONG>opts</STRONG> argu-
ment is not presently used, but is reserved for the future
- (leave it <STRONG>NULL</STRONG>). Note that changing the attributes does
- not imply that a subsequent <STRONG>refresh</STRONG> will update the screen
- to match, since the character values are not modified.
- Use <STRONG>touchwin</STRONG> to force the screen to match the updated at-
- tributes.
+ (leave it <STRONG>NULL</STRONG>).
<STRONG>Attributes</STRONG>
The following video attributes, defined in <STRONG><curses.h></STRONG>, can
be passed to the routines <STRONG>attron</STRONG>, <STRONG>attroff</STRONG>, and <STRONG>attrset</STRONG>, or
OR'd with the characters passed to <STRONG>addch</STRONG>.
-
<STRONG>A_NORMAL</STRONG> Normal display (no highlight)
<STRONG>A_STANDOUT</STRONG> Best highlighting mode of the terminal.
<STRONG>A_UNDERLINE</STRONG> Underlining
<STRONG>tr_set</STRONG>. These are intended to work with a new series of
highlight macros prefixed with <STRONG>WA_</STRONG>.
+ Older versions of this library did not force an update of
+ the screen when changing the attributes. Use <STRONG>touchwin</STRONG> to
+ force the screen to match the updated attributes.
<STRONG>WA_NORMAL</STRONG> Normal display (no highlight)
<STRONG>WA_STANDOUT</STRONG> Best highlighting mode of the terminal.
This implementation returns an error if the window pointer
is null. The <STRONG>wcolor_set</STRONG> function returns an error if the
color pair parameter is outside the range 0..COL-
- OR_PAIRS-1.
+ OR_PAIRS-1. This implementation also provides <STRONG>getattrs</STRONG>
+ for compatibility with older versions of curses.
+
+ Functions with a "mv" prefix first perform a cursor move-
+ ment using <STRONG>wmove</STRONG>, and return an error if the position is
+ outside the window, or if the window pointer is null.
</PRE>
<H2>SEE ALSO</H2><PRE>
<STRONG><A HREF="ncurses.3x.html">curses(3x)</A></STRONG>, <STRONG><A HREF="curs_addch.3x.html">curs_addch(3x)</A></STRONG>, <STRONG><A HREF="curs_addstr.3x.html">curs_addstr(3x)</A></STRONG>,
- <STRONG><A HREF="curs_bkgd.3x.html">curs_bkgd(3x)</A></STRONG>, <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG>
+ <STRONG><A HREF="curs_bkgd.3x.html">curs_bkgd(3x)</A></STRONG>, <STRONG><A HREF="curs_printw.3x.html">curs_printw(3x)</A></STRONG>, <STRONG><A HREF="curs_variables.3x.html">curs_variables(3x)</A></STRONG>