XDestroyWindowEvent(3)

📦
version 1.8.14 · 8 versions
, in alpine 3.24, arch rolling, nixos 26.05, nixpkgs unstable

💅 XDestroyWindowEvent(3) — DestroyNotify event structure ✨

okay bestie, we're in the XLIB FUNCTIONS chapter — yes, the manual name is right there — and this page is all about the DestroyNotify event structure. it's giving "window said bye" energy 💀 but in a very structured C way, and honestly? iconic.

✨ NAME ✨

XDestroyWindowEvent — DestroyNotify event structure 🫶

🦋 STRUCTURES 🦋

The structure for DestroyNotify events contains:

       typedef struct {
               int type;       /* DestroyNotify */
               unsigned long serial;   /* # of last request processed by server */
               Bool send_event;        /* true if this came from a SendEvent request */
               Display *display;       /* Display the event was read from */
               Window event;
               Window window;
       } XDestroyWindowEvent;

When you receive this event, the structure members are set as follows — periodt:

  • type 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. 👑
  • display is set to a pointer to the display the event was read on. 🖥️
  • send_event is set to True if the event came from a SendEvent protocol request. ✅
  • serial 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. 🔢
  • window is set to the window that is most useful to toolkit dispatchers. 🪟

and then the plot thickens 😭:

The event member is set either to the destroyed window or to its parent, depending on whether StructureNotify or SubstructureNotify was selected. 👀

The window member is set to the window that is destroyed. 💥

🎀 SEE ALSO 🎀

go read these next, bestie 🫶:

okay bye ily 💖 the footer line says X Version 11, libX11 1.8.14, and XDestroyWindowEvent(3) — that's the source, version, and date footer, and we are so done here 🌈✨

📦 where this page comes from