XSetWMColormapWindows


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, col- ormap_windows_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_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 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 ALSO

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

Man(1) output converted with man2html