XSetWMColormapWindows

Syntax

Status XSetWMColormapWindows(display, w, colormap_windows, count)
      Display *display;
      Window w;
      Window *colormap_windows;
      int count;

Arguments

display Specifies the connection to the X server.
w Specifies the window.
colormap_windows Specifies the list of windows.
count Specifies the number of windows in the list.

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.

Diagnostics

BadAlloc The server failed to allocate the requested source or server memory.
BadWindow A value for a Window argument does not name a defined Window.

See also

XAllocClassHint(), XAllocIconSize(), XAllocSizeHints(), XAllocWMHints(), XGetWMColormapWindows(), XSetCommand(), XSetTextProperty(), XSetTransientForHint(), XSetWMClientMachine(), XSetWMColormapWindows(), XSetWMIconName(), XSetWMName(), XSetWMProperties(), XSetWMProtocols(), XStringListToTextProperty(), "Setting and Reading the WM_TRANSIENT_FOR Property".
Christophe Tronche, ch@tronche.com