NAME

XListInstalledColormaps − get a list of installed colormaps. 

Synopsis

Colormap *XListInstalledColormaps(display, w, num_return)
display *display;
Window w;
int *num_return;

Arguments

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

wSpecifies the ID of the window for whose screen you want the list of currently installed colormaps. 

num_return
Returns the number of currently installed colormaps in the returned list.

Description

XListInstalledColormaps() returns a list of the currently installed colormaps for the screen containing the specified window.  The order in the list is not significant.  There is no distinction in the list between colormaps actually being used by windows and colormaps no longer in use which have not yet been freed or destroyed.  The allocated list should be freed using XFree() when it is no longer needed.  For more information on installing colormaps, see Volume One, Chapter 7, Color. 

Errors

BadWindow

See Also

DefaultColormap(), DisplayCells(), XCopyColormapAndFree(), XCreateColormap(), XFreeColormap(), XGetStandardColormap(), XInstallColormap(), XSetStandardColormap(), XSetWindowColormap(), XUninstallColormap(). 

Copyright O’Reilly & Assoc.  —