XGetWMColor(3x) — HPUX 9.05

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

displaySpecifies a connection to an X server; returned from XOpenDisplay().

wSpecifies 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.

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. XGetWMColormapWindows() stores the list in its colormap_windows_return argument. If the property exists, is of type WINDOW, is of format 32, and the atom WM_COLORMAP_WINDOWS can be interned, XGetWMColormapWindows() 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 10, Interclient Communication.

Errors

BadWindow