XInstallColormap(3X11) X11R5 XInstallColormap(3X11)NAME
XInstallColormap, XUninstallColormap, XListInstalledColormaps - control
colormaps
SYNTAX
XInstallColormap(display, colormap)
Display *display;
Colormap colormap;
XUninstallColormap(display, colormap)
Display *display;
Colormap colormap;
Colormap *XListInstalledColormaps(display, w, num_return)
Display *display;
Window w;
int *num_return;
ARGUMENTS
colormap Specifies the colormap.
display Specifies the connection to the X server.
num_return
Returns the number of currently installed colormaps.
w Specifies the window that determines the screen.
DESCRIPTION
The function installs the specified colormap for its associated screen.
All windows associated with this colormap immediately display with true
colors. You associated the windows with this colormap when you created
them by calling or
If the specified colormap is not already an installed colormap, the X
server generates a event on each window that has that colormap. In
addition, for every other colormap that is installed as a result of a
call to the X server generates a event on each window that has that
colormap.
can generate a error.
The function removes the specified colormap from the required list for
its screen. As a result, the specified colormap might be uninstalled,
and the X server might implicitly install or uninstall additional col‐
ormaps. Which colormaps get installed or uninstalled is server-depen‐
dent except that the required list must remain installed.
If the specified colormap becomes uninstalled, the X server generates a
event on each window that has that colormap. In addition, for every
other colormap that is installed or uninstalled as a result of a call
to the X server generates a event on each window that has that col‐
ormap.
can generate a error.
The function returns a list of the currently installed colormaps for
the screen of the specified window. The order of the colormaps in the
list is not significant and is no explicit indication of the required
list. When the allocated list is no longer needed, free it by using
can generate a error.
DIAGNOSTICS
A value for a Colormap argument does not name a defined Colormap.
A value for a Window argument does not name a defined Window.
SEE ALSOXChangeWindowAttributes(3X11), XCreateColormap(3X11), XCreateWin‐
dow(3X11), XFree(3X11)
Xlib - C Language X Interface
XInstallColormap(3X11)