XUninstallColormap() XUninstallColormap()
Name
XUninstallColormap - uninstall a colormap; install default if not already installed.
Synopsis
XUninstallColormap(display, colormap)
Display *display;
Colormap colormap;
Arguments
display Specifies a connection to an X server; returned from XOpenDisplay().
colormap Specifies the colormap to be uninstalled.
Description
If colormap is an installed map for its screen, it is uninstalled. If the screen's default colormap is not installed, it is installed.
If colormap is an installed map, a ColormapNotify event is generated on every window having this colormap as an attribute. If a colormap
is installed as a result of the uninstall, a ColormapNotify event is generated on every window having that colormap as an attribute.
At any time, there is a subset of the installed colormaps, viewed as an ordered list, called the required list. The length of the required
list is at most the min_maps specified for each screen in the Display structure. When a colormap is installed with XInstallColormap() it
is added to the head of the required list and the last colormap in the list is removed if necessary to keep the length of the list at
min_maps. When a colormap is uninstalled with XUninstallColormap() and it is in the required list, it is removed from the list. No other
actions by the server or the client change the required list. It is important to realize that on all but high-performance workstations,
min_maps is likely to be one.
For more information on installing and uninstalling colormaps, see Volume One, Chapter 7, Color.
Errors
BadColor Invalid colormap.
See Also
XDefaultColormap(), XDisplayCells(), XCopyColormapAndFree(), XCreateColormap(), XFreeColormap(), XGetStandardColormap(), XInstallCol-
ormap(), XListInstalledColormaps(), XSetStandardColormap(), XSetWindowColormap().
Xlib - Colormaps XUninstallColormap()
