XConfigureEvent(3)

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

🦋 XConfigureEvent(3) — ConfigureNotify event structure

okay bestie, welcome to the Xlib Functions page for XConfigureEvent(3). This is the ConfigureNotify event structure, and we're gonna get into every single member, no skipped lore. 💅

💖 NAME

XConfigureEvent — the ConfigureNotify event structure. That's the name, that's the vibe, that's the whole point. ✨

✨ STRUCTURES ✨

The structure for ConfigureNotify events contains:

typedef struct {
        int type;       /* ConfigureNotify */
        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;
        int x, y;
        int width, height;
        int border_width;
        Window above;
        Bool override_redirect;
} XConfigureEvent;

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. (Yes, window has more tea below — same member, different context, stay with me. 🫶)

The event member is set either to the reconfigured window or to its parent, depending on whether StructureNotify or SubstructureNotify was selected. The window member is set to the window whose size, position, border, and/or stacking order was changed.

The x and y members are set to the coordinates relative to the parent window's origin and indicate the position of the upper-left outside corner of the window. The width and height members are set to the inside size of the window, not including the border. The border_width member is set to the width of the window's border, in pixels.

The above member is set to the sibling window and is used for stacking operations. If the X server sets this member to None, the window whose state was changed is on the bottom of the stack with respect to sibling windows. However, if this member is set to a sibling window, the window whose state was changed is placed on top of this sibling window.

The override_redirect member is 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 🎀

okay that's the whole page, bestie! footer tea: X Version 11, libX11 1.8.14 — and the original footer doesn't list a separate date, so that's all the metadata we're spilling. mwah 💋🎀

📦 where this page comes from