X-Git-Url: https://ncurses.scripts.mit.edu/?p=ncurses.git;a=blobdiff_plain;f=doc%2Fhtml%2Fman%2Fcurs_bkgrnd.3x.html;h=4e86eeeec0081b23b12e044b1f38b3482dfb2719;hp=c2b106344a5ac91a7c071aeb101c4a957c18a9a9;hb=9f479192e3ca3413d235c66bf058f8cc63764898;hpb=6a530b46563470c2ca73579d1994a0c8e275dd98 diff --git a/doc/html/man/curs_bkgrnd.3x.html b/doc/html/man/curs_bkgrnd.3x.html index c2b10634..4e86eeee 100644 --- a/doc/html/man/curs_bkgrnd.3x.html +++ b/doc/html/man/curs_bkgrnd.3x.html @@ -1,6 +1,7 @@ -
- --curs_bkgrnd(3x) curs_bkgrnd(3x) +curs_bkgrnd(3X) curs_bkgrnd(3X) --
- bkgrnd, wbkgrnd, bkgrndset, wbkgrndset, getbkgrnd, wget- - bkgrnd - curses window complex background manipulation - routines +
+ bkgrnd, wbkgrnd, bkgrndset, wbkgrndset, getbkgrnd, wgetbkgrnd - curses + window complex background manipulation routines --
- #include <curses.h> +
+ #include <curses.h> - int bkgrnd( const cchar_t *wch); - int wbkgrnd( WINDOW *win, const cchar_t *wch); - void bkgrndset(const cchar_t *wch ); - void wbkgrndset(WINDOW *win, const cchar_t *wch); - int getbkgrnd(cchar_t *wch); - int wgetbkgrnd(WINDOW *win, cchar_t *wch); + int bkgrnd( const cchar_t *wch); + int wbkgrnd( WINDOW *win, const cchar_t *wch); + void bkgrndset(const cchar_t *wch ); + void wbkgrndset(WINDOW *win, const cchar_t *wch); --
+ int getbkgrnd(cchar_t *wch); + int wgetbkgrnd(WINDOW *win, cchar_t *wch); --
- The bkgrndset and wbkgrndset routines manipulate the back- - ground of the named window. The window background is a - cchar_t consisting of any combination of attributes (i.e., - rendition) and a complex character. The attribute part of - the background is combined (OR'ed) 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 background - 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 particular terminal, the - attribute part of the background is displayed as the - graphic rendition of the character put on the screen. +
--
- The bkgrnd and wbkgrnd functions set the background prop- - erty of the current or specified window and then apply - this setting to every character position in that window: +
+ The bkgrndset and wbkgrndset routines manipulate the background of the + named window. The window background is a cchar_t consisting of any + combination of attributes (i.e., rendition) and a complex character. + The attribute part of the background is combined (OR'ed) 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 background becomes a property of the + character and moves with the character through any scrolling and + insert/delete line/character operations. - o The rendition of every character on the screen is - changed to the new background rendition. + 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. - o Wherever the former background character appears, it - is changed to the new background character. +
+ The bkgrnd and wbkgrnd functions set the background property of the + current or specified window and then apply this setting to every + character position in that window: --
- The getbkgrnd function returns the given window's current - background character/attribute pair via the wch pointer. + o The rendition of every character on the screen is changed to the + new background rendition. + o Wherever the former background character appears, it is changed to + the new background character. --
- Note that bkgrnd, bkgrndset, and getbkgrnd may be macros. +
+ The getbkgrnd function returns the given window's current background + character/attribute pair via the wch pointer. If the given window + pointer is null, the character is not updated (but no error returned). --
- The bkgrndset and wbkgrndset routines do not return a - value. - Upon successful completion, the other functions return OK. - Otherwise, they return ERR. A null window pointer is - treated as an error. +
+ Note that bkgrnd, bkgrndset, and getbkgrnd may be macros. + X/Open Curses does not provide details on how the rendition is changed. + This implementation follows the approach used in SVr4 curses, which is + explained in the manual page for wbkgd. --
- curses(3x), curs_bkgd(3x) + +
+ The bkgrndset and wbkgrndset routines do not return a value. + + Upon successful completion, the other functions return OK. Otherwise, + they return ERR: + + o A null window pointer is treated as an error. + + o A null character pointer is treated as an error. + + +
+ These functions are described in the XSI Curses standard, Issue 4 + (X/Open Curses). + + +
+ curses(3X), curs_bkgd(3X) - curs_bkgrnd(3x) + curs_bkgrnd(3X)