NAME

XUninstallColormap — uninstall a colormap; install default if not already installed. 

SYNOPSIS

XUninstallColormap(display, colormap) Display ∗display; Colormap colormap;

ARGUMENTS

displaySpecifies a connection to an X server; returned from XOpenDisplay(). 

colormapSpecifies 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

BadColorInvalid colormap. 

SEE ALSO

XDefaultColormap(), XDisplayCells(), XCopyColormapAndFree(), XCreateColormap(), XFreeColormap(), XGetStandardColormap(), XInstallColormap(), XListInstalledColormaps(), XSetStandardColormap(), XSetWindowColormap(). 

Xlib Reference Manual