---
name: "XSetWMColormapWindows"
section: "3x"
platform: "linux"
package: "libx11-dev"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/XSetWMColormapWindows/3x"
---

# XSetWMColormapWindows(3x)

set or read a window's WM\_COLORMAP\_WINDOWS property

## NAME

XSetWMColormapWindows, XGetWMColormapWindows - set or read a window's WM\_COLORMAP\_WINDOWS property

## SYNTAX

Status XSetWMColormapWindows(Display \**display*, Window *w*, Window \**colormap\_windows*, int *count*);

Status XGetWMColormapWindows(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, *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.

*XSetWMColormapWindows* can generate *BadAlloc* and *BadWindow* errors.

The  *XGetWMColormapWindows* function returns the list of window 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 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(3X11), XAllocIconSize(3X11), XAllocSizeHints(3X11), XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11), XSetTransientForHint(3X11), XSetTextProperty(3X11), XSetWMClientMachine(3X11), XSetWMIconName(3X11), XSetWMName(3X11), XSetWMProperties(3X11), XSetWMProtocols(3X11), XStringListToTextProperty(3X11)\
 *Xlib - C Language X Interface*