XLIB Programming Manual, Rel. 5, Third Edition

Name

PropertyNotify — xproperty

When Generated

A PropertyNotify event indicates that a property of a window has changed or been deleted. This event can also be used to get the current server time (by appending zero-length data to a property). PropertyNotify events are generated by XChangeProperty(), XDeleteProperty(), XGetWindowProperty(), or XRotateWindowProperties().

Select With

This event is selected with PropertyChangeMask.

XEvent Structure Name

typedef union _XEvent {
    ...
    XPropertyEvent xproperty;
    ...
} 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;
    Atom atom;
    Time time;
    int state;                /* PropertyNewValue, PropertyDeleted */
} XPropertyEvent;

Event Structure Members

window

The window whose property was changed, not the window that selected the event.

atom

The property that was changed.

state

Either PropertyNewValue or PropertyDeleted. Whether the property was changed to a new value or deleted.

time

The time member specifies the server time when the property was changed.