Content-type: text/html Man page of curs_attr

curs_attr

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

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

SYNOPSIS

#include <curses.h>

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

LIBRARY

Curses Library (libcurses)
 

STANDARDS

Interfaces documented on this reference page conform to industry standards as follows:

attroff, wattroff, attron, wattron, attrset, wattrset, standend, wstandend, standout, wstandout:  XPG4, XPG4-UNIX

Refer to the standards(5) reference page for more information about industry standards and associated tags.
 

DESCRIPTION

These routines manipulate the current attributes of the current or specified 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, attributes are displayed as the graphic rendition of characters put on the screen.

The routine attrset sets the current attributes of the 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 equivalent to attron(A_STANDOUT). The routine standend is equivalent to attrset(0); that is, standend turns off all attributes.
 

Attributes

The following video attributes, which are defined in <curses.h>, can be passed to the routines attron, attroff, and attrset. The attributes also can be combined (by using an inclusive OR operation) with characters passed to addch.

A_ALTCHARSETAlternate character set
A_BLINKBlinking
A_BOLDExtra bright or bold
A_DIMHalf bright
A_INVISInvisible
A_PROTECTProtected
A_REVERSEReverse video
A_STANDOUTBest highlighting mode of the terminal.
A_UNDERLINEUnderlining


 

NOTES

The header file <curses.h> automatically includes the header file <stdio.h>.

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

RETURN VALUES

These routines always return OK.
 

SEE ALSO

Functions: curses(3), curs_addch(3), curs_addstr(3), curs_attr_get(3), curs_printw(3)

Others: standards(5)


 

Index

NAME
SYNOPSIS
LIBRARY
STANDARDS
DESCRIPTION
Attributes
NOTES
RETURN VALUES
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:41:25 GMT, October 02, 2010