Curses Library Functions                       cursbkgd(3CURSES)



NAME
     cursbkgd, bkgd, bkgdset, wbkgdset, wbkgd  -  curses  window
     background manipulation routines

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

     int bkgd(chtype ch);


     void bkgdset(chtype ch);


     void wbkgdset(WINDOW *win, chtype ch);


     int wbkgd(WINDOW *win, chtype ch);


DESCRIPTION
     The bkgdsets() and wbkgdset() routines manipulate the  back-
     ground  of the named window. Background is a chtype consist-
     ing of any combination of attributes and  a  character.  The
     attribute part of the background is combined (ORed) with all
     non-blank characters that are written into the window   with
     waddch().  Both  the  character  and  attribute parts of the
     background are combined with the blank characters. The back-
     ground  becomes  a  property of the character and moves with
     the  character  through  any  scrolling  and   insert/delete
     line/character  operations. To the extent possible on a par-
     ticular terminal, the attribute part of  the  background  is
     displayed  as  the graphic rendition of the character put on
     the screen.


     The bkgd() and wbkgd() routines combine the  new  background
     with  every position in the window. Background is any combi-
     nation of attributes and a  character.  Only  the  attribute
     part  is used to set the background of non-blank characters,
     while both character and attributes are used for blank posi-
     tions.  To the extent possible on a particular terminal, the
     attribute part of the background is displayed as the graphic
     rendition of the character put on the screen.

RETURN VALUES
     bkgd() and wbkgd() return the integer OK, or a  non-negative
     integer, if immedok() is set. See cursoutopts(3CURSES).

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



SunOS 5.11          Last change: 31 Dec 1996                    1






Curses Library Functions                       cursbkgd(3CURSES)



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     MT-Level                     Unsafe                      
    


SEE ALSO
     cursaddch(3CURSES), cursoutopts(3CURSES), curses(3CURSES),
     attributes(5)

NOTES
     The header   automatically  includes  the  headers
      and .


     Note that bkgdset() and bkgd() may be macros.






































SunOS 5.11          Last change: 31 Dec 1996                    2