XSetWMColormapWindows(3X11XLIB FUNCTIOXSetWMColormapWindows(3X11)NAME
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-
erty on the specified window. These identifiers indicate
X Version 11 Release 6.4 1
XSetWMColormapWindows(3X11XLIB FUNCTIOXSetWMColormapWindows(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 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 ALSOXAllocClassHint(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 2