XSetWMColormapWindows(3) XLIB FUNCTIONS XSetWMColormapWindows(3)

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

SYNTAX
       Status XSetWMColormapWindows(Display *display, Window w, Window *col‐
              ormapwindows, int count);

       Status XGetWMColormapWindows(Display *display, Window w, Window **col‐
              ormapwindowsreturn, 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 WMCOLORMAPWINDOWS
       property on the specified window with the list of windows specified by
       the colormapwindows argument.  It the property does not already exist,
       XSetWMColormapWindows sets the WMCOLORMAPWINDOWS property on the
       specified window to the list of windows specified by the colormapwin‐
       dows argument.  The property is stored with a type of WINDOW and a for‐
       mat of 32.  If it cannot intern the WMCOLORMAPWINDOWS atom, XSetWM‐
       ColormapWindows 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 identi‐
       fiers stored in the WMCOLORMAPWINDOWS property on the specified win‐
       dow.  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 WMCOLORMAPWINDOWS can be
       interned, XGetWMColormapWindows sets the windowsreturn argument to a
       list of window identifiers, sets the countreturn argument to the num‐
       ber 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
       WMCOLORMAPWINDOWS
                 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(3), XAllocIconSize(3), XAllocSizeHints(3), XAl‐
       locWMHints(3), XFree(3), XSetCommand(3), XSetTransientForHint(3), XSet‐
       TextProperty(3), XSetWMClientMachine(3), XSetWMIconName(3), XSetWM‐
       Name(3), XSetWMProperties(3), XSetWMProtocols(3), XStringListTo‐
       TextProperty(3)
       Xlib - C Language X Interface



X Version 11                     libX11 1.6.5         XSetWMColormapWindows(3)