XSetWMColormapWindows(3X11)AIX (XLIB FUNCTIONS)XSetWMColormapWindows(3X11) NAME XSetWMColormapWindows, XGetWMColormapWindows - set or read a window's WM_COLORMAP_WINDOWS property SYNTAX Status XSetWMColormapWindows(_d_i_s_p_l_a_y, _w, _c_o_l_o_r_m_a_p__w_i_n_d_o_w_s, _c_o_u_n_t) Display *_d_i_s_p_l_a_y; Window _w; Window *_c_o_l_o_r_m_a_p__w_i_n_d_o_w_s; int _c_o_u_n_t; Status XGetWMColormapWindows(_d_i_s_p_l_a_y, _w, _c_o_l_o_r_m_a_p__w_i_n_d_o_w_s__r_e_t_u_r_n, _c_o_u_n_t__r_e_t_u_r_n) Display *_d_i_s_p_l_a_y; Window _w; Window **_c_o_l_o_r_m_a_p__w_i_n_d_o_w_s__r_e_t_u_r_n; int *_c_o_u_n_t__r_e_t_u_r_n; ARGUMENTS _d_i_s_p_l_a_y Specifies the connection to the X server. _c_o_l_o_r_m_a_p__w_i_n_d_o_w_s Specifies the list of windows. _c_o_l_o_r_m_a_p__w_i_n_d_o_w_s__r_e_t_u_r_n Returns the list of windows. _c_o_u_n_t Specifies the number of windows in the list. _c_o_u_n_t__r_e_t_u_r_n Returns the number of windows in the list. _w Specifies the window. DESCRIPTION The _X_S_e_t_W_M_C_o_l_o_r_m_a_p_W_i_n_d_o_w_s function replaces the WM_COLORMAP_WINDOWS property on the specified window with the list of windows specified by the colormap_windows argu- ment. It the property does not already exist, _X_S_e_t_W_M_C_o_l_o_r_- _m_a_p_W_i_n_d_o_w_s sets the WM_COLORMAP_WINDOWS property on the specified window to the list of windows specified by the colormap_windows argument. The property is stored with a type of WINDOW and a format of 32. If it cannot intern the WM_COLORMAP_WINDOWS atom, _X_S_e_t_W_M_C_o_l_o_r_m_a_p_W_i_n_d_o_w_s returns a zero status. Otherwise, it returns a nonzero status. _X_S_e_t_W_M_C_o_l_o_r_m_a_p_W_i_n_d_o_w_s can generate _B_a_d_A_l_l_o_c and _B_a_d_W_i_n_d_o_w errors. The _X_G_e_t_W_M_C_o_l_o_r_m_a_p_W_i_n_d_o_w_s function returns the list of win- dow identifiers stored in the WM_COLORMAP_WINDOWS property on the specified window. These identifiers indicate the Rev. Release 5 Page 1 XSetWMColormapWindows(3X11)AIX (XLIB FUNCTIONS)XSetWMColormapWindows(3X11) colormaps that the window manager may need to install for this window. If the property exists, is of type WINDOW, is of format 32, and the atom WM_COLORMAP_WINDOWS can be interned, _X_G_e_t_W_M_C_o_l_o_r_m_a_p_W_i_n_d_o_w_s sets the windows_return argument to a list of window identifiers, sets the count_return argument to the number of elements in the list, and returns a nonzero status. Otherwise, it sets neither of the return arguments and returns a zero status. To release the list of window identifiers, use _X_F_r_e_e. _X_G_e_t_W_M_C_o_l_o_r_m_a_p_W_i_n_d_o_w_s can generate a _B_a_d_W_i_n_d_o_w error. PROPERTIES WM_COLORMAP_WINDOWS The list of window IDs that may need a different colormap than that of their top-level window. DIAGNOSTICS _B_a_d_A_l_l_o_c The server failed to allocate the requested resource or server memory. _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a defined Window. SEE ALSO XAllocClassHint(3X11), XAllocIconSize(3X11), XAllocSizeHints(3X11), XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11), XSetTransientForHint(3X11), XSetTextProperty(3X11), XSetWMClientMachine(3X11), XSetWMIconName(3X11), XSetWMName(3X11), XSetWMProperties(3X11), XSetWMProtocols(3X11), XStringListToTextProperty(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 2