NAME
XSetWMColormapWindows, XGetWMColormapWindows - set or read a window's WM_COLORMAP_WINDOWS property
SYNTAX
Status XSetWMColormapWindows(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(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 argument.
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 window identifiers stored
in the WM_COLORMAP_WINDOWS property on the specified window.
These identifiers indicate the 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
from 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