ATTROFF(3XCURSES) X/Open Curses Library Functions ATTROFF(3XCURSES)
NAME
attroff, attron, attrset, wattroff, wattron, wattrset - change
foreground window attributes
SYNOPSIS
cc [
flag... ]
file...
-I /usr/xpg4/include
-L /usr/xpg4/lib \
-R /usr/xpg4/lib
-lcurses [
library... ]
c89 [
flag... ]
file...
-lcurses [
library... ]
#include <curses.h>
int attroff(
int attrs);
int attron(
int attrs);
int attrset(
int attrs);
int wattroff(
WINDOW *win,
int attrs);
int wattron(
WINDOW *win,
int attrs);
int wattrset(
WINDOW *win,
int attrs);
DESCRIPTION
The
attroff() and
attron() functions unset and set, respectively,
the specified window attributes of
stdscr. These functions only
affect the attributes specified; attributes that existed before the
call are retained. The
wattroff() and
wattron() functions unset or
set the specified attributes for window
win.
The
attrset() and
wattrset() functions change the specified window
renditions of
stdscr and
win to new values; the old values are not
retained.
The attributes that can be used are specified in the
Attributes, Color Pairs, and Renditions section of the
curses(3XCURSES) man
page.
Here is an example that prints some text using the current window
rendition, adds underlining, changes the attributes, prints more
text, then changes the attributes back.
printw("This word is");
attron(A_UNDERLINE);
printw("underlined.");
attroff(A_NORMAL);
printw("This is back to normal text.\n");
refresh();
PARAMETERS
attrs are the foreground window attributes to be set or unset.
win Is a pointer to the window in which attribute changes are to
be made.
RETURN VALUES
These functions always return
OK or 1.
ERRORS
None.
USAGE
All of these functions may be macros.
ATTRIBUTES
See
attributes(7) for descriptions of the following attributes:
+--------------------+-----------------+
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+--------------------+-----------------+
|Interface Stability | Standard |
+--------------------+-----------------+
|MT-Level | Unsafe |
+--------------------+-----------------+
SEE ALSO
addch(3XCURSES),
addnstr(3XCURSES),
attr_get(3XCURSES),
bkgdset(3XCURSES),
curses(3XCURSES),
init_color(3XCURSES),
libcurses(3XCURSES),
start_color(3XCURSES),
attributes(7),
standards(7) June 5, 2002 ATTROFF(3XCURSES)
