XConfigureRequestEvent(3)

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

💖 NAME 💖

okay bestie, you've landed on XConfigureRequestEvent(3) — a page from XLIB FUNCTIONS — and it's literally the ConfigureRequest event structure. That's the NAME section, no cap. 🦋

✨ STRUCTURES ✨

The structure for ConfigureRequest events contains this, and we are not skipping a single field:

       typedef struct {
               int type;       /* ConfigureRequest */
               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;
               Window window;
               int x, y;
               int width, height;
               int border_width;
               Window above;
               int detail;     /* Above, Below, TopIf, BottomIf, Opposite */
               unsigned long value_mask;
       } XConfigureRequestEvent;

When you receive this event, the structure members are set as follows. Field-by-field lore time:

  • type — set to the event type constant name that uniquely identifies it. 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. like, “where was this event read from?” energy.
  • 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. tiny bits, full 32-bit glow-up.
  • window — set to the window that is most useful to toolkit dispatchers.

Then the rest of the reconfigure info:

  • parent — set to the parent window.
  • window — set to the window whose size, position, border width, and/or stacking order is to be reconfigured. yes, window shows up twice on this page — it’s giving double duty.
  • value_mask — indicates which components were specified in the ConfigureWindow protocol request. The corresponding values are reported as given in the request. The remaining values are filled in from the current geometry of the window, except in the case of above (sibling) and detail (stack-mode), which are reported as None and Above, respectively, if they are not given in the request. 🫶

🌈 SEE ALSO 🌈

the whole Xlib event squad, in the exact order:

And the big-picture one: Xlib - C Language X Interface. 👑

that's the page, bestie! the original footer stamps this as X Version 11, libX11 1.8.14, and XConfigureRequestEvent(3) — source/version/date-line energy, fr fr. 🎀💅✨

📦 where this page comes from