xcb_unmap_window(3)

📦
version 1.17.0 · 4 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_unmap_window — the XCB Requests page, bestie edition ✨

okay so this is xcb_unmap_window(3), from the XCB Requests manual. it's the little guy you call when you want a window to just… ✨disappear✨ (visually, anyway). let's get into it 💅

🌸 NAME 🌸

xcb_unmap_window — makes a window invisible 🫥

🎀 SYNOPSIS 🎀

#include <xcb/xproto.h>

💖 Request function 💖

xcb_void_cookie_t xcb_unmap_window(xcb_connection_t *conn,
       xcb_window_t window);

🦋 REQUEST ARGUMENTS 🦋

  • conn — your XCB connection to X11. the whole vibe pipeline, the link between you and the server 🫶
  • window — the window you're about to make invisible. say bye bestie 👋

🌈 DESCRIPTION 🌈

Unmaps the specified window. which is a fancy way of saying: it makes that window invisible, and all of its child windows too. the whole little family goes ghost mode 🫥✨

and because nothing in X ever happens quietly, unmapping a window leads to the UnmapNotify event being generated. also? Expose events get generated for formerly obscured windows — so everything that was hiding behind your window is about to wake up and be like "oh we're visible now?!" 😭

💜 RETURN VALUE 💜

Returns an xcb_void_cookie_t. and ngl, that's the tea: errors (if any) have to be handled in the event loop, not right here. the cookie is just the receipt, the drama arrives later 📬

if you'd rather handle errors directly with xcb_request_check instead, use xcb_unmap_window_checked. see xcb-requests(3) for details. iykyk 👑

💀 ERRORS 💀

  • xcb_window_error_t — the specified window does not exist. like, you tried to unmap a window that isn't there. nothing to unmute, bestie, it's giving ghost 🫠

🌟 SEE ALSO 🌟

👑 AUTHOR 👑

Generated from xproto.xml. Contact xcb@lists.freedesktop.org for corrections and improvements. so if you spot something off, you know who to email fr fr 💌

and that's the whole page, no cap. this came to you from X Version 11, libxcb 1.17.0, dated as ever and looking iconic 💅✨ thanks for reading, mwah 🫶

📦 where this page comes from