hpux man page for xgetwmcolormapwindows

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()