NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO
#include <curses.h>int bkgd(chtype ch);
Is a pointer to the background character to be set.
Is a pointer to the window in which the background character is to be set.
All characters except space are part of the foreground. The character and its attributes make up a character/rendition pair defined as a chtype. The character is any single-byte value; the attribute consists of highlighting attributes that affect the appearance of the character on the screen (for example, bold, underline, color).
The bkgdset() function sets the current background character and rendition for the stdscr window. wbkgdset() sets the current background character and rendition for window win. You must specify the complete character/rendition pair; for example:
bkgdset(A_BOLD|COLOR_PAIR(1)|` ');
sets the background rendition to bold with color and the background character to a space. The default background character/rendition pair is
bkgdset(A_NORMAL|COLOR_PAIR(0)|` ');
The current background character and rendition are written to the window by the clear(3XC), erase(3XC), clrtoeol(3XC), and clrtobot(3XC) sets of functions as well as any other functions that insert blanks. If a background character is not supplied (that is, only a rendition is given), results are undefined.
The bkgd() and wbkgd() functions update the entire window (stdscr and win, respectively) with the supplied background and perform a wbkgdset().
On success, the bkgd() and wbkgd() functions return OK. Otherwise, they return ERR.
The bkgdset() and wbkgdset() functions do not return a value.
On success, the getbkgd() function returns the background character and rendition for the specified window. Otherwise, it returns ERR.
None.
addch(3XC), addchstr(3XC), attroff(3XC), bkgrnd(3XC), clear(3XC), clrtoeol(3XC), clrtobot(3XC), erase(3XC), inch(3XC), mvprintw(3XC)
NAME | SYNOPSIS | PARAMETERS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO