XCreateWindowEvent(3)

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

✨ NAME ✨

okay so this is the XCreateWindowEvent(3) page from XLIB FUNCTIONS — literally the XCreateWindowEvent glow-up, aka the CreateNotify event structure. 💅

🛠️ STRUCTURES 🛠️

The structure for CreateNotify events contains this, and yes bestie, every field is doing main character work:

typedef struct {
        int type;       /* CreateNotify */
        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 parent;  /* parent of the window */
        Window window;  /* window id of window created */
        int x, y;       /* window location */
        int width, height;      /* size of window */
        int border_width;       /* border width */
        Bool override_redirect; /* creation should be overridden */
} XCreateWindowEvent;

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

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

Then the created-window specifics, because this event is literally about a window being created:

  • parent — set to the created window's parent.
  • window — specifies the created window.
  • x, y — set to the created window's coordinates relative to the parent window's origin, and they indicate the position of the upper-left outside corner of the created window.
  • width, height — set to the inside size of the created window (not including the border), and they are always nonzero.
  • border_width — set to the width of the created window's border, in pixels.
  • override_redirect — set to the override-redirect attribute of the window.
Window manager clients normally should ignore this window if the override_redirect member is True. 👀

👀 SEE ALSO 👀

Xlib - C Language X Interface

💖 source/version tea: X Version 11, libX11 1.8.14. date: the original footer doesn’t show one, so I’m not inventing a date — periodt. 💖

📦 where this page comes from