NAME
XChangeWindowAttributes, XSetWindowBackground, XSetWindowBackgroundPixmap, XSetWindowBorder, XSetWindowBorderPixmap, XSetWindowColormap - change window attributes
SYNTAX
int XChangeWindowAttributes(Display *_d_i_s_p_l_a_y, Window _w, unsigned long _v_a_l_u_e_m_a_s_k, XSetWindowAttributes *_a_t_t_r_i_b_u_t_e_s);
int XSetWindowBackground(Display *_d_i_s_p_l_a_y, Window _w, unsigned long _b_a_c_k_g_r_o_u_n_d___p_i_x_e_l);
int XSetWindowBackgroundPixmap(Display *_d_i_s_p_l_a_y, Window
_w, Pixmap _b_a_c_k_g_r_o_u_n_d___p_i_x_m_a_p);
int XSetWindowBorder(Display *_d_i_s_p_l_a_y, Window _w, unsigned long _b_o_r_d_e_r___p_i_x_e_l);
int XSetWindowBorderPixmap(Display *_d_i_s_p_l_a_y, Window _w, Pixmap _b_o_r_d_e_r___p_i_x_m_a_p);
int XSetWindowColormap(Display *_d_i_s_p_l_a_y, Window _w, Colormap _c_o_l_o_r_m_a_p);
ARGUMENTS
-
_a_t_t_r_i_b_u_t_e_s
Specifies the structure from which the values (as specified by the value mask)
-
are to be taken.
The value mask should have the appropriate bits
set to indicate which attributes have been set in the structure.
-
_b_a_c_k_g_r_o_u_n_d___p_i_x_e_l
Specifies the pixel that is to be used for the background.
-
-
_b_a_c_k_g_r_o_u_n_d___p_i_x_m_a_p
Specifies the background pixmap,
-
_P_a_r_e_n_t_R_e_l_a_t_i_v_e,
or
_N_o_n_e.
-
_b_o_r_d_e_r___p_i_x_e_l
Specifies the entry in the colormap.
-
-
_b_o_r_d_e_r___p_i_x_m_a_p
Specifies the border pixmap or
-
_C_o_p_y_F_r_o_m_P_a_r_e_n_t.
-
_d_i_s_p_l_a_y
Specifies the connection to the X server.
-
-
_v_a_l_u_e_m_a_s_k
Specifies which window attributes are defined in the attributes
-
argument.
This mask is the bitwise inclusive OR of the valid attribute mask bits.
If valuemask is zero,
the attributes are ignored and are not referenced.
-
_w
Specifies the window.
-
-
_c_o_l_o_r_m_a_p
Specifies the colormap.
-
DESCRIPTION
Depending on the valuemask,
the
_X_C_h_a_n_g_e_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s
function uses the window attributes in the
_X_S_e_t_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s
structure to change the specified window attributes.
Changing the background does not cause the window contents to be
changed.
To repaint the window and its background, use
_X_C_l_e_a_r_W_i_n_d_o_w.
Setting the border or changing the background such that the
border tile origin changes causes the border to be repainted.
Changing the background of a root window to
_N_o_n_e
or
_P_a_r_e_n_t_R_e_l_a_t_i_v_e
restores the default background pixmap.
Changing the border of a root window to
_C_o_p_y_F_r_o_m_P_a_r_e_n_t
restores the default border pixmap.
Changing the win-gravity does not affect the current position of the
window.
Changing the backing-store of an obscured window to
_W_h_e_n_M_a_p_p_e_d
or
_A_l_w_a_y_s,
or changing the backing-planes, backing-pixel, or
save-under of a mapped window may have no immediate effect.
Changing the colormap of a window (that is, defining a new map, not
changing the contents of the existing map) generates a
_C_o_l_o_r_m_a_p_N_o_t_i_f_y
event.
Changing the colormap of a visible window may have no
immediate effect on the screen because the map may not be installed
(see
_X_I_n_s_t_a_l_l_C_o_l_o_r_m_a_p).
Changing the cursor of a root window to
_N_o_n_e
restores the default
cursor.
Whenever possible, you are encouraged to share colormaps.
Multiple clients can select input on the same window.
Their event masks are maintained separately.
When an event is generated,
it is reported to all interested clients.
However, only one client at a time can select for
_S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k,
_R_e_s_i_z_e_R_e_d_i_r_e_c_t_M_a_s_k,
and
_B_u_t_t_o_n_P_r_e_s_s_M_a_s_k.
If a client attempts to select any of these event masks
and some other client has already selected one,
a
_B_a_d_A_c_c_e_s_s
error results.
There is only one do-not-propagate-mask for a window,
not one per client.
_X_C_h_a_n_g_e_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s
can generate
_B_a_d_A_c_c_e_s_s,
_B_a_d_C_o_l_o_r,
_B_a_d_C_u_r_s_o_r,
_B_a_d_M_a_t_c_h,
_B_a_d_P_i_x_m_a_p,
_B_a_d_V_a_l_u_e,
and
_B_a_d_W_i_n_d_o_w
errors.
The
_X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d
function sets the background of the window to the specified pixel value.
Changing the background does not cause the window contents to be changed.
_X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d
uses a pixmap of undefined size filled with the pixel value you passed.
If you try to change the background of an
_I_n_p_u_t_O_n_l_y
window, a
_B_a_d_M_a_t_c_h
error results.
_X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d
can generate
_B_a_d_M_a_t_c_h
and
_B_a_d_W_i_n_d_o_w
errors.
The
_X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d_P_i_x_m_a_p
function sets the background pixmap of the window to the specified pixmap.
The background pixmap can immediately be freed if no further explicit
references to it are to be made.
If
_P_a_r_e_n_t_R_e_l_a_t_i_v_e
is specified,
the background pixmap of the window's parent is used,
or on the root window, the default background is restored.
If you try to change the background of an
_I_n_p_u_t_O_n_l_y
window, a
_B_a_d_M_a_t_c_h
error results.
If the background is set to
_N_o_n_e,
the window has no defined background.
_X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d_P_i_x_m_a_p
can generate
_B_a_d_M_a_t_c_h,
_B_a_d_P_i_x_m_a_p,
and
_B_a_d_W_i_n_d_o_w
errors.
The
_X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r
function sets the border of the window to the pixel value you specify.
If you attempt to perform this on an
_I_n_p_u_t_O_n_l_y
window, a
_B_a_d_M_a_t_c_h
error results.
_X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r
can generate
_B_a_d_M_a_t_c_h
and
_B_a_d_W_i_n_d_o_w
errors.
The
_X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r_P_i_x_m_a_p
function sets the border pixmap of the window to the pixmap you specify.
The border pixmap can be freed immediately if no further explicit
references to it are to be made.
If you specify
_C_o_p_y_F_r_o_m_P_a_r_e_n_t,
a copy of the parent window's border pixmap is used.
If you attempt to perform this on an
_I_n_p_u_t_O_n_l_y
window, a
_B_a_d_M_a_t_c_h
error results.
_X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r_P_i_x_m_a_p
can generate
_B_a_d_M_a_t_c_h,
_B_a_d_P_i_x_m_a_p,
and
_B_a_d_W_i_n_d_o_w
errors.
The
_X_S_e_t_W_i_n_d_o_w_C_o_l_o_r_m_a_p
function sets the specified colormap of the specified window.
The colormap must have the same visual type as the window,
or a
_B_a_d_M_a_t_c_h
error results.
_X_S_e_t_W_i_n_d_o_w_C_o_l_o_r_m_a_p
can generate
_B_a_d_C_o_l_o_r,
_B_a_d_M_a_t_c_h,
and
_B_a_d_W_i_n_d_o_w
errors.
DIAGNOSTICS
-
_B_a_d_A_c_c_e_s_s
-
A client attempted
to free a color map entry that it did not already allocate.
-
_B_a_d_A_c_c_e_s_s
-
A client attempted
to store into a read-only color map entry.
-
_B_a_d_C_o_l_o_r
-
A value for a Colormap argument does not name a defined Colormap.
-
_B_a_d_C_u_r_s_o_r
-
A value for a Cursor argument does not name a defined Cursor.
-
_B_a_d_M_a_t_c_h
-
Some argument or pair of arguments has the correct type and range but fails
to match in some other way required by the request.
-
_B_a_d_M_a_t_c_h
-
An
_I_n_p_u_t_O_n_l_y
window locks this attribute.
-
_B_a_d_P_i_x_m_a_p
-
A value for a Pixmap argument does not name a defined Pixmap.
-
_B_a_d_V_a_l_u_e
-
Some numeric value falls outside the range of values accepted by the request.
Unless a specific range is specified for an argument, the full range defined
by the argument's type is accepted. Any argument defined as a set of
alternatives can generate this error.
-
_B_a_d_W_i_n_d_o_w
-
A value for a Window argument does not name a defined Window.
SEE ALSO
XConfigureWindow(3X11),
XCreateWindow(3X11),
XDestroyWindow(3X11),
XInstallColormap(3X11),
XMapWindow(3X11),
XRaiseWindow(3X11),
XUnmapWindow(3X11)
_X_l_i_b _- _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e