XLIB Programming Manual, Rel. 5, Third Edition

Name

ColormapNotify — xcolormap

When Generated

A ColormapNotify event reports when the colormap attribute of a window changes or when the colormap specified by the attribute is installed, uninstalled, or freed. This event is generated by XChangeWindowAttributes(), XFreeColormap(), XInstallColormap(), and XUninstallColormap().

Select With

This event is selected with ColormapChangeMask.

XEvent Structure Name

typedef union _XEvent {
    ...
    XColormapEvent xcolormap;
    ...
} XEvent;

Event Structure

typedef struct {
    int type;
    unsigned long serial;    /* # of last request processed by server */
    Bool send_event;         /* True if this came from SendEvent request */
    Display *display;        /* Display the event was read from */
    Window window;
    Colormap colormap;       /* a colormap or None */
    Bool new;
    int state;               /* ColormapInstalled, ColormapUninstalled */
} XColormapEvent;

Event Structure Members

window

The window whose associated colormap or attribute changes.

colormap

The colormap associated with the window, either a colormap ID or the constant None. It will be None only if this event was generated due to an XFreeColormap call.

new

True when the colormap attribute has been changed, or False when the colormap is installed or uninstalled.

state

Either ColormapInstalled or ColormapUninstalled; it indicates whether the colormap is installed or uninstalled.