XSetWMColormapWindows(3X11)
XLIB FUNCTION
XSetWMColormapWindows(3X11)


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

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

       Status XGetWMColormapWindows(display, w, col-
       ormapwindowsreturn, countreturn)
             Display *display;
             Window w;
             Window **colormapwindowsreturn;
             int *countreturn;

ARGUMENTS
       display   Specifies the connection to the X server.

       colormapwindows
                 Specifies the list of windows.

       colormapwindowsreturn
                 Returns the list of windows.

       count     Specifies the number of windows in the list.

       countreturn
                 Returns the number of windows in the list.

       w         Specifies the window.

DESCRIPTION
       The XSetWMColormapWindows function replaces the
       WM_COLORMAP_WINDOWS property on the specified window with
       the list of windows specified by the colormap_windows
       argument.  It the property does not already exist, XSetWM-
       ColormapWindows 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-
       erty on the specified window.  These identifiers indicate



X Version 11                Release 5                           1

XSetWMColormapWindows(3X11)
XLIB FUNCTION
XSetWMColormapWindows(3X11)


       the colormaps that the window manager may need to install
       for this window.  If the property exists, is of type WIN-
       DOW, is of format 32, and the atom WM_COLORMAP_WINDOWS can
       be interned, XGetWMColormapWindows sets the windows_return
       argument to a list of window identifiers, sets the
       count_return argument to the number of elements in the
       list, and returns a nonzero status.  Otherwise, it sets
       neither of the return arguments and returns a zero status.
       To release the list of window identifiers, use XFree.

       XGetWMColormapWindows can generate a BadWindow error.

PROPERTIES
       WM_COLORMAP_WINDOWS
                 The list of window IDs that may need a different
                 colormap than 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 5                           2