---
name: "XPropertyEvent"
section: "3x"
platform: "linux"
package: "libx11-dev"
version: "4.3.0.dfsg.1-14sarge7"
release: "Debian 3.1 (Sarge)"
platforms: ["linux"]
url: "https://new.carta.tech/XPropertyEvent/3x"
---

# XPropertyEvent(3x)

PropertyNotify event structure

## NAME

XPropertyEvent - PropertyNotify event structure

## STRUCTURES

The structure for *PropertyNotify* events contains:

```
typedef struct {
	int type;
	unsigned long serial;
	Bool send_event;
	Display *display;
	Window window;
	Atom atom;
	Time time;
	int state;
} XPropertyEvent;

```

When you receive this event, the structure members are set as follows.

The type member is set to the event type constant name that uniquely identifies it. For example, when the X server reports a *GraphicsExpose* event to a client application, it sends an *XGraphicsExposeEvent* structure with the type member set to *GraphicsExpose*. The display member is set to a pointer to the display the event was read on. The send\_event member is set to *True* if the event came from a *SendEvent* protocol request. The serial member is set from the serial number reported in the protocol but expanded from the 16-bit least-significant bits to a full 32-bit value. The window member is set to the window that is most useful to toolkit dispatchers.

The window member is set to the window whose associated  property was changed. The atom member is set to the property's atom and indicates which property was changed or desired. The time member is set to the server time when the property was changed. The state member is set to indicate whether the property was changed  to a new value or deleted and can be *PropertyNewValue* or *PropertyDelete*. The state member is set to *PropertyNewValue* when a property of the window is changed using *XChangeProperty* or *XRotateWindowProperties* (even when adding zero-length data using *XChangeProperty*) and when replacing all or part of a property with identical data using *XChangeProperty* or  *XRotateWindowProperties*. The state member is set to *PropertyDelete* when a property of the window is deleted using *XDeleteProperty* or, if the delete argument is  *True*, *XGetWindowProperty*.

## SEE ALSO

XAnyEvent(3X11), XButtonEvent(3X11), XCreateWindowEvent(3X11), XCirculateEvent(3X11), XCirculateRequestEvent(3X11), XColormapEvent(3X11), XConfigureEvent(3X11), XConfigureRequestEvent(3X11), XCrossingEvent(3X11), XDestroyWindowEvent(3X11), XErrorEvent(3X11), XExposeEvent(3X11), XFocusChangeEvent(3X11), XGetWindowProperty(3X11), XGraphicsExposeEvent(3X11), XGravityEvent(3X11), XKeymapEvent(3X11), XMapEvent(3X11), XMapRequestEvent(3X11), XReparentEvent(3X11), XResizeRequestEvent(3X11), XSelectionClearEvent(3X11), XSelectionEvent(3X11), XSelectionRequestEvent(3X11), XUnmapEvent(3X11), XVisibilityEvent(3X11)\
 *Xlib - C Language X Interface*