XGetWMColormapWindows()XGetWMColormapWindows()NameXGetWMColormapWindows – get a window's WM_COLORMAP_WINDOWS property.
Synopsis
Status XGetWMColormapWindows(display, w, colormap_windows_return,
count_return)
Display *display;
Window w;
Window **colormap_windows_return;
int count_return;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the top-level window of an application.
colormap_windows_return
Returns the list of windows that have custom colormaps.
count_return
Returns the number of windows in the list.
Returns
Zero on failure, non-zero on success.
Availability
Release 4 and later.
DescriptionXGetWMColormapWindows() gets the WM_COLORMAP_WINDOWS property on the
specified window. This property contains a list of windows that have
custom colomaps that need to be installed. The XGetWMColormapWindows()
function stores the list in its colormap_windows_return argument.
If the property exists, if it is of type WINDOW, if it is of format 32,
and if the atom WM_COLORMAP_WINDOWS can be interned, XGetWMColormapWin‐
dows() sets the colormap_windows_return argument to a list of window
identifiers, sets the count_return argument to the number of elements
in list, and returns a non-zero status. Otherwise, it sets neither of
the return arguments and returns a zero status. To release the list of
window identifiers, use XFree().
This function is called by window managers to find out what colormaps
to install and when to install them.
For more information, see Volume One, Chapter 12, Interclient Communi‐
cation.
Errors
BadWindow
See AlsoXSetWMColormapWindows().
Xlib - Window Manager Hints XGetWMColormapWindows()