curs_attr(3X)							 curs_attr(3X)

NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

     #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);

DESCRIPTION    [Toc]    [Back]

     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    [Toc]    [Back]
     The following video attributes, defined in	<curses.h>, can	be passed to
     the routines attron, attroff, and attrset,	or OR-ed 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<b>)	 Color-pair number n






									Page 1






curs_attr(3X)							 curs_attr(3X)



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

	  PAIR_NUMBER(attrs<b>)Returns the	pair number associated
			 with the COLOR_PAIR(n<b>)	attribute.

RETURN VALUE    [Toc]    [Back]

     These routines always return 1.

NOTES    [Toc]    [Back]

     The header	file <curses.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.

SEE ALSO    [Toc]    [Back]

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


									PPPPaaaaggggeeee 2222