XCB_COMPOSITE_UNREDIRECT_SUBWINDOWS(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. πŸ’–βœ¨πŸŽ€