XCB_COMPOSITE_UNREDIRECT_WINDOW(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_window 💖

okay bestie, welcome to the xcb_composite_unredirect_window page from the XCB Requests manual 💅 this is your girl's guide to telling X11 "okay we're DONE with that whole redirection thing, put it back" 🎀

✨ NAME ✨

xcb_composite_unredirect_window — terminate redirection of the specified window. that's it. that's the whole job. un-redirect. un-do. reverse. slay 🦋

✨ SYNOPSIS ✨

first things first, you gotta pull in the header:

#include <xcb/composite.h>

🍓 Request function

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

like, look at that signature. gorgeous. iconic. three lil arguments and she's done 🫶

✨ REQUEST ARGUMENTS ✨

  • conn — your XCB connection to X11. the whole line of communication to the X server, your main character honestly 💜
  • window — the window you're terminating redirection of. heads up though: it must have been redirected by the current client, or a Value error results. so like, don't try to un-redirect somebody else's window, that's not your business, that's not your era 🙈
  • update — the update type that was passed to RedirectWindows. and if this doesn't match the update type you requested previously? yeah, Value error again. they gotta match, no cap ✋

✨ DESCRIPTION ✨

redirection of the specified window will be terminated. boom. done. closed. that window is free now, she's released, she's living her unredirected truth ✨

🚨 BUT — this cannot be used if the window was redirected with RedirectSubwindows. like literally cannot. don't even try it. different vibe entirely, wrong tool, wrong girl 💀

✨ RETURN VALUE ✨

you get back an xcb_void_cookie_t — a lil void cookie, cute right? 🍪 and any errors (if there even are any) have to be handled over in the event loop, not here.

if you'd rather handle errors directly with xcb_request_check instead, then use xcb_composite_unredirect_window_checked — she's the checked version, she'll tell you what's wrong. see xcb-requests(3) for the deets 🌸

✨ ERRORS ✨

this request does never generate any errors. never. none. zero. not a single one. 😭 so if you were bracing for drama, there is none. she's a clean queen 👑

✨ SEE ALSO ✨

✨ AUTHOR ✨

generated from composite.xml. contact xcb@lists.freedesktop.org for corrections and improvements — like if something's wrong, tell them, not me, i'm just the messenger 🧚

okay that's the whole page, you ate that 💅 and before you go — this lil beauty comes to you from X Version 11, libxcb 1.17.0, courtesy of the XCB Requests crew. go unredirect something responsibly, love u, bye 👑💖

📦 where this page comes from