curs_bkgd(3X)                                       curs_bkgd(3X)



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

SYNOPSIS
     #include <curses.h>

     void bkgdset(chtype ch);
     void wbkgdset(WINDOW *win, chtype ch);
     int bkgd(chtype ch);
     int wbkgd(WINDOW *win, chtype ch);

DESCRIPTION
     The bkgdset and wbkgdset routines manipulate the background
     of the named window.  Background is a chtype consisting of
     any combination of attributes and a character.  The attri-
     bute 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 back-
     ground 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 combination
     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 positions.
     To the extent possible on a particular terminal, the attri-
     bute part of the background is displayed as the graphic ren-
     dition of the character put on the screen.

RETURN VALUE
     bkgd and wbkgd return the integer OK, or a non-negative
     integer, if immedok is set.

NOTES
     The header file <curses.h> automatically includes the header
     files <stdio.h> and <unctrl.h>.

     Note that bkgdset and bkgd may be macros.

SEE ALSO
     curses(3X), curs_addch(3X), curs_outopts(3X).







Page 1                        CX/UX Programmer's Reference Manual