XCB_COMPOSITE_UNREDIRECT_SUBWINDOWS_CHECKED(3)

📦
version 1.17.0 · 5 versions
, in alpine 3.22, alpine 3.23, alpine 3.24, arch rolling, centos-stream 10, debian trixie, fedora 43, fedora 44, nixpkgs unstable, opensuse-leap 16.0, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 xcb_composite_unredirect_subwindows — a manual page bestie 💖

okay so this is a page from the XCB Requests manual, and it's all about xcb_composite_unredirect_subwindows. yes the name is a whole mouthful, we're gonna get through it together, no cap. 🫶

✨ NAME ✨

xcb_composite_unredirect_subwindows — terminate redirection of the specified window's children

like... the opposite of setting the redirection up. we're wrapping it up. closing the tab. saying bye. 💅

🌸 SYNOPSIS 🌸

#include <xcb/composite.h>

Request function

xcb_void_cookie_t
       xcb_composite_unredirect_subwindows(xcb_connection_t *conn,
       xcb_window_t window, uint8_t update);

🎀 REQUEST ARGUMENTS 🎀

  • conn — your XCB connection to X11. the whole vibe conduit. everything flows through here. 🦋
  • window — the window whose redirection you're terminating. heads up bestie: this one must have previously been selected for sub-redirection by the current client. if it wasn't? a Value error results. so like, don't just roll up and unredirect a random window, it's giving trespassing. 😭
  • update — the update type that was passed to RedirectSubWindows. and fr fr, listen: if this does not match the previously requested update type, a Value error results. it's gotta be the same one, periodt. 👑

🌈 DESCRIPTION 🌈

Redirection of all children of window will be terminated.

that's it. that's the whole thing. all the children, unredirected, done. the curtains close. 🎭✨

🍓 RETURN VALUE 🍓

Returns an xcb_void_cookie_t. any errors (if there even are any) have to be handled in the event loop, okay? that's just the deal.

if you'd rather handle errors directly with xcb_request_check instead, then use xcb_composite_unredirect_subwindows_checked. same vibe, checked flavour. see xcb-requests(3) for the details, iykyk. 📖

💜 ERRORS 💜

This request does never generate any errors.

not one. zero. the error-free main character. iconic behaviour honestly 🌈⭐

🦋 SEE ALSO 🦋

👑 AUTHOR 👑

Generated from composite.xml. Contact xcb@lists.freedesktop.org for corrections and improvements.

like yes it was auto-generated but they do want your feedback, so if something's off, tell them, don't just suffer in silence. 🫶

and that's the whole page bestie!! this was X Version 11, libxcb 1.17.0, so you know it's the real deal. go unredirect those subwindows, you absolute legend. 💖✨🎀

📦 where this page comes from