XVisibilityEvent(3)

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

✨ NAME ✨

XVisibilityEvent — the VisibilityNotify event structure. Bestie, we're in the XLIB FUNCTIONS manual and this page is XVisibilityEvent(3), so let's get into it 💅.

🧚 STRUCTURES 🧚

The VisibilityNotify event structure is literally this, no cap:

typedef struct {
        int type;       /* VisibilityNotify */
        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 window;
        int state;
} XVisibilityEvent;

When you receive this event, the structure members are set like this 👇

  • 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 window comes back for round two: the window member is set to the window whose visibility state changes. The state member is set to the state of the window's visibility, and it can be VisibilityUnobscured, VisibilityPartiallyObscured, or VisibilityFullyObscured.

The X server ignores all of a window's subwindows when determining the visibility state of the window, and processes VisibilityNotify events according to the following:
  • When the window changes state from partially obscured, fully obscured, or not viewable to viewable and completely unobscured, the X server generates the event with the state member of the XVisibilityEvent structure set to VisibilityUnobscured.
  • When the window changes state from viewable and completely unobscured or not viewable to viewable and partially obscured, the X server generates the event with the state member of the XVisibilityEvent structure set to VisibilityPartiallyObscured.
  • When the window changes state from viewable and completely unobscured, viewable and partially obscured, or not viewable to viewable and fully obscured, the X server generates the event with the state member of the XVisibilityEvent structure set to VisibilityFullyObscured.

🦋 SEE ALSO 🦋

That's the whole page, bestie — footer says X Version 11 and libX11 1.8.14, signed as XVisibilityEvent(3). No date is printed in this footer, so no invented calendar tea 🌸.

📦 where this page comes from