XSetWMColormapWindows, XGetWMColormapWindows - set or read
       a window's WM_COLORMAP_WINDOWS property


SYNTAX

       Status XSetWMColormapWindows(display, w, colormap_windows,
       count)
             Display *display;
             Window w;
             Window *colormap_windows;
             int count;

       Status XGetWMColormapWindows(display, w, colormap_win-
       dows_return, count_return)
             Display *display;
             Window w;
             Window **colormap_windows_return;
             int *count_return;


ARGUMENTS

       display   Specifies the connection to the X server.

       colormap_windows
                 Specifies the list of windows.

       colormap_windows_return
                 Returns the list of windows.

       count     Specifies the number of windows in the list.

       count_return
                 Returns the number of windows in the list.

       w         Specifies the window.


DESCRIPTION

       The XSetWMColormapWindows function replaces the WM_COL-
       ORMAP_WINDOWS property on the specified window with the
       list of windows specified by the colormap_windows argu-
       ment.  It the property does not already exist, XSetWMCol-
       ormapWindows 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, XSetWMColormapWindows
       returns a zero status.  Otherwise, it returns a nonzero
       status.

       XSetWMColormapWindows can generate BadAlloc and BadWindow
       errors.

       The XGetWMColormapWindows function returns the list of
       window identifiers stored in the WM_COLORMAP_WINDOWS prop-
       WM_COLORMAP_WINDOWS
                 The list of window IDs that may need a different
                 colormap from that of their top-level window.


DIAGNOSTICS

       BadAlloc  The server failed to allocate the requested
                 resource or server memory.

       BadWindow A value for a Window argument does not name a
                 defined Window.


SEE ALSO

       XAllocClassHint(3X11), XAllocIconSize(3X11), XAllocSize-
       Hints(3X11), XAllocWMHints(3X11), XFree(3X11), XSetCom-
       mand(3X11), XSetTransientForHint(3X11), XSetTextProp-
       erty(3X11), XSetWMClientMachine(3X11), XSetWMIcon-
       Name(3X11), XSetWMName(3X11), XSetWMProperties(3X11),
       XSetWMProtocols(3X11), XStringListToTextProperty(3X11)
       Xlib - C Language X Interface



X Version 11               Release 6.4                          1