Curses Library Functions                       cursattr(3CURSES)



NAME
     cursattr, attroff, wattroff, attron, wattron, attrset, wat-
     trset,  standend,  wstandend,  standout,  wstandout - curses
     character and window attribute control routines

SYNOPSIS
     cc [ flag ... ] file ... -lcurses [ library ... ]
     #include 

     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
     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  termi-
     nal,  they are displayed as the graphic rendition of charac-
     ters put on the screen.






SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                       cursattr(3CURSES)



     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(ASTANDOUT).  The routine standend() is the
     same as attrset(), that is, it turns off all attributes.

  Attributes
     The following video attributes, defined in  ,  can
     be   passed   to   the  routines  attron(),  attroff(),  and
     attrset(), or OR-ed with the characters passed to addch().

     ASTANDOUT       Best highlighting mode of the terminal


     AUNDERLINE      Underlining


     AREVERSE        Reverse video


     ABLINK          Blinking


     ADIM            Half bright


     ABOLD           Extra bright or bold


     ALTCHARSET     Alternate character set


     ACHARTEXT       Bit-mask to extract a character


     COLORPAIR(n)    Color-pair number n



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

     PAIRNUMBER(attrs)    Returns  the  pair  number  associated
                           with the COLORPAIR(n) attribute


RETURN VALUES
     These routines always return 1.

ATRIBUTES




SunOS 5.11          Last change: 31 Dec 1996                    2






Curses Library Functions                       cursattr(3CURSES)



     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     cursaddch(3CURSES),                   cursaddstr(3CURSES),
     cursprintw(3CURSES), curses(3CURSES), attributes(5)

NOTES
     The header   automatically  includes  the  headers
      and .


     Note that attroff(), wattroff(), attron(),  wattron(),  wat-
     trset(), standend(), and standout() may be macros.
































SunOS 5.11          Last change: 31 Dec 1996                    3