XChangeWindowAttributes(3X11)AIX (XLIB FUNCTIONS)XChangeWindowAttributes(3X11) NAME XChangeWindowAttributes, XSetWindowBackground, XSetWin- dowBackgroundPixmap, XSetWindowBorder, XSetWindowBorderPix- map, XSetWindowColormap - change window attributes SYNTAX XChangeWindowAttributes(_d_i_s_p_l_a_y, _w, _v_a_l_u_e_m_a_s_k, _a_t_t_r_i_b_u_t_e_s) 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; XSetWindowBackground(_d_i_s_p_l_a_y, _w, _b_a_c_k_g_r_o_u_n_d__p_i_x_e_l) 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; XSetWindowBackgroundPixmap(_d_i_s_p_l_a_y, _w, _b_a_c_k_g_r_o_u_n_d__p_i_x_m_a_p) 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; XSetWindowBorder(_d_i_s_p_l_a_y, _w, _b_o_r_d_e_r__p_i_x_e_l) Display *_d_i_s_p_l_a_y; Window _w; unsigned long _b_o_r_d_e_r__p_i_x_e_l; XSetWindowBorderPixmap(_d_i_s_p_l_a_y, _w, _b_o_r_d_e_r__p_i_x_m_a_p) Display *_d_i_s_p_l_a_y; Window _w; Pixmap _b_o_r_d_e_r__p_i_x_m_a_p; XSetWindowColormap(_d_i_s_p_l_a_y, _w, _c_o_l_o_r_m_a_p) 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. Rev. Release 5 Page 1 XChangeWindowAttributes(3X11)AIX (XLIB FUNCTIONS)XChangeWindowAttributes(3X11) _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 back- ground 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 back- ground 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 win- dow 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. How- ever, 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. Rev. Release 5 Page 2 XChangeWindowAttributes(3X11)AIX (XLIB FUNCTIONS)XChangeWindowAttributes(3X11) _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 back- ground 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 back- ground pixmap can immediately be freed if no further expli- cit 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 Rev. Release 5 Page 3 XChangeWindowAttributes(3X11)AIX (XLIB FUNCTIONS)XChangeWindowAttributes(3X11) 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 gen- erate 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 Rev. Release 5 Page 4