carta
xcb_destroy_window_checked(3)

xcb_destroy_window_checked3

Destroys a window

Part of xcb_destroy_window(3).

Usage

Request function

xcb_void_cookie_t xcb_destroy_window(xcb_connection_t *conn, xcb_window_t window);

Request arguments

conn

The XCB connection to X11.

window

The window to destroy.

Overview

Destroys the specified window and all of its subwindows. A DestroyNotify event is generated for each destroyed window (a DestroyNotify event is first generated for any given window's inferiors). If the window was mapped, it will be automatically unmapped before destroying.

Calling DestroyWindow on the root window will do nothing.

Return value

Returns an xcb_void_cookie_t. Errors (if any) have to be handled in the event loop.

If you want to handle errors directly with xcb_request_check instead, use xcb_destroy_window_checked. See xcb-requests(3) for details.

Errors

xcb_window_error_t

The specified window does not exist.

History

  • Arch Linux 2026-11-01 to Debian 13 (Trixie): the text shown here
  • Debian 12 (Bookworm)
  • Debian 11 (Bullseye)
  • Debian 10 (Buster)
  • Debian 9 (Stretch)

Author

Generated from xproto.xml. Contact [email protected] for corrections and improvements.

From libxcb 1.17.0-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.