Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
attroff(3XCURSES)	X/Open Curses Library Functions	     attroff(3XCURSES)

NAME
       attroff,	 attron,  attrset,  wattroff, wattron, wattrset	- change fore-
       ground 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  re-
       tained. The wattroff() and wattron() functions unset or set the	speci-
       fied 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 re-
       tained.

       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 ren-
       dition, 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(5) 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(5), standards(5)

SunOS 5.10			  5 Jun	2002		     attroff(3XCURSES)

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | RETURN VALUES | ERRORS | USAGE | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=attroff&sektion=3xcurses&manpath=SunOS+5.10>

home | help