XSetWMColormapWindows(3X)               XSetWMColormapWindows(3X)



NAME
     XSetWMColormapWindows, XGetWMColormapWindows - set and get a
     window's WM_COLORMAP_WINDOWS property

SYNOPSIS
     Status XSetWMColormapWindows(display, w, colormap-windows,
     count)
     Display *display;
     Window w;
     Window *colormap-windows;
     int count;

     Status XGetWMColormapWindows(display, w, colormap-windows-
     return, count-return)
     Display *display;
     Window w;
     Window **colormap-windows-return;
     int *count-return;

DESCRIPTION
     The XSetWMColormapWindows function replaces the
     WM_COLORMAP_WINDOWS property on the specified window with
     the list of windows specified by the Icolormap-windows argu-
     ment.  If the property does not already exist,
     XSetWMColormapWindows 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.

     The XGetWMColormapWindows function returns the list of win-
     dow identifiers stored in the WM_COLORMAP_WINDOWS property
     on the specified window.  These identifiers indicate the
     colormaps that the window manager may need to install for
     this window.  If the property exists, is of type WINDOW, is
     of format 32, and the atom WM_COLORMAP_WINDOWS can be in-
     terned, XGetWMColormapWindows sets windows-return to a list
     of window identifiers, sets count-return to the number of
     elements in 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.

   Arguments
     These functions accept the following arguments:

     display Specifies the connection to the X server.

     colormap-windows
             Specifies the list of windows.




November, 1990                                                  1

XSetWMColormapWindows(3X)               XSetWMColormapWindows(3X)



     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.

   Properties
     These functions use the following property:

     WM_COLORMAP_WINDOWS
             Lists the window IDs that may need a different
             colormap than that of their top-level window.

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

     BadWindow
             A value for a Window argument does not name a de-
             fined Window.

     The XSetWMColormapWindows function can generate
     BadAlloc and BadWindow errors.

     The XGetWMColormapWindows function can generate a BadWindow
     error.

SEE ALSO
     XAllocClassHint(3X), XAllocIconSize(3X),
     XAllocSizeHints(3X), XAllocWMHints(3X), XFree(3X),
     XSetCommand(3X), XSetTransientForHint(3X),
     XSetTextProperty(3X), XSetWMClientMachine(3X),
     XSetWMIconName(3X), XSetWMName(3X), XSetWMProperties(3X),
     XSetWMProtocols(3X), XStringListToTextProperty(3X)

     Xlib - C Language Interface















2                                                  November, 1990