curs_attr(3ocurses)

curs_attr: attroff, wattroff, attron, wattron, attrset, wattrset, standend, wstandend, standout, wstandout -- curses character and window attribute control routines

Synopsis

cc [flag . . .] file -locurses [library . . .]

#include <ocurses.h>

int attroff(chtype attrs);
int wattroff(WINDOW win, chtype attrs);
int attron(chtype attrs);
int wattron(WINDOW win, chtype attrs);
int attrset(chtype attrs);
int wattrset(WINDOW win, chtype attrs);
int standend(void);
int wstandend(WINDOW win);
int standout(void);
int wstandout(WINDOW win);

Description

All of these routines manipulate the current attributes of the named window. The current attributes of a window are applied to all characters that are written into the window with waddch, waddstr and wprintw. Attributes are a property of the character, and move with the character through any scrolling and insert/delete line/character operations. To the extent possible on the particular terminal, they are displayed as the graphic rendition of characters put on the screen.

The routine attrset sets the current attributes of the given window to attrs. The routine attroff turns off the named attributes without turning any other attributes on or off. The routine attron turns on the named attributes without affecting any others. The routine standout is the same as attron(A_STANDOUT). The routine standend is the same as attrset(0), that is, it turns off all attributes.

Attributes

The following video attributes, defined in ocurses.h, can be passed to the routines attron, attroff, and attrset, or ORed with the characters passed to addch.

A_STANDOUT: Best highlighting mode of the terminal.
A_UNDERLINE: Underlining
A_REVERSE: Reverse video
A_BLINK: Blinking
A_DIM: Half bright
A_BOLD: Extra bright or bold
A_ALTCHARSET: Alternate character set
A_CHARTEXT: Bit-mask to extract a character
COLOR_PAIR(n): Color-pair number n

The following macro is the reverse of COLOR_PAIR(n):

PAIR_NUMBER(attrs): Return the pair number associated with the COLOR_PAIR(n) attribute.

Return values

These routines always return 1.

References

curses(3ocurses), curs_addch(3ocurses), curs_addstr(3ocurses), curs_printw(3ocurses)

Notices

The header file ocurses.h automatically includes the header files stdio.h and unctrl.h.

Note that attroff, wattroff, attron, wattron, attrset, wattrset, standend and standout may be macros.