Lines Matching +full:out +full:- +full:of +full:- +full:window

2 .\" Copyright 2018-2023,2024 Thomas E. Dickey                                *
3 .\" Copyright 2002-2015,2017 Free Software Foundation, Inc.                  *
5 .\" Permission is hereby granted, free of charge, to any person obtaining a  *
6 .\" copy of this software and associated documentation files (the            *
10 .\" copies of the Software, and to permit persons to whom the Software is    *
14 .\" in all copies or substantial portions of the Software.                   *
16 .\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS  *
17 .\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF               *
20 .\" DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR    *
21 .\" OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR    *
24 .\" Except as contained in this notice, the name(s) of the above copyright   *
31 .TH curs_bkgrnd 3X 2024-04-20 "ncurses @NCURSES_MAJOR@.@NCURSES_MINOR@" "Library calls"
53 \fB\%wgetbkgrnd\fP \-
54 manipulate background of a \fIcurses\fP window of wide characters
60 \fBint wbkgrnd(WINDOW *\fIwin\fP, const cchar_t *\fIwch\fP);
63 \fBvoid wbkgrndset(WINDOW *\fIwin\fP, const cchar_t *\fIwch\fP);
66 \fBint wgetbkgrnd(WINDOW *\fIwin\fP, cchar_t *\fIwch\fP);
73 window
77 combining a set of attributes
82 The blank character is a spacing character that populates a window's
84 The background's attributes are combined with all non-blank characters
85 written to the window,
86 as with the \fB\%wadd_wch\fP(3X) and \fB\%wins_wch\fP(3X) families of
89 The blank character and attributes of the background combine with
90 characters written to the window as described below.
91 The background becomes a property of the character and moves with it
95 the attribute part of the background is displayed as the graphic
96 rendition of the character put on the screen.
98 \fB\%bkgrnd\fP and \fB\%wbkgrnd\fP set the background property of
99 \fB\%stdscr\fP or the specified window and then apply this setting to
100 every character cell in that window.
102 The rendition of every character in the window changes to the new
109 updates the rendition of each character cell by comparing the character,
110 non-color attributes,
112 The library applies to following procedure to each cell in the window,
131 and its background color matches that of the current window background,
135 It finishes by setting the cell's background to use the new window
139 and its background color does not match that of the current window
142 updates only the non-color attributes,
147 treats a background character value of zero (0) as a blank character.
154 \fB\%bkgrndset\fP and \fB\%wbkgrndset\fP manipulate the background of
155 the applicable window,
161 background character and attribute pair of \fB\%stdscr\fP or the
162 specified window and store it via the
178 .I \%WINDOW
194 Unlike their counterparts in the non-\*(``wide\*('' configuration of
206 X/Open Curses does not provide details of how the rendition is updated.
211 non-\*(``wide\*('' configuration of