XGetWMColormapWindows() XGetWMColormapWindows()
Name
XGetWMColormapWindows - 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.
Description
XGetWMColormapWindows() 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, XGetWMCol-
ormapWindows() 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 Communication.
Errors
BadWindow
See Also
XSetWMColormapWindows().
Xlib - Window Manager Hints XGetWMColormapWindows()
