xcb_circulate_window(3)

xcb_circulate_window3

Change window stacking order

Usage

#include <xcb/xproto.h>

Request function

xcb_void_cookie_t xcb_circulate_window(xcb_connection_t *conn, uint8_t direction, xcb_window_t window);

Request arguments

conn

The XCB connection to X11.

direction

One of the following values:

XCB_CIRCULATE_RAISE_LOWEST

TODO: NOT YET DOCUMENTED.

XCB_CIRCULATE_LOWER_HIGHEST

TODO: NOT YET DOCUMENTED.

window

The window to raise/lower (depending on direction).

Overview

If direction is XCB_CIRCULATE_RAISE_LOWEST, the lowest mapped child (if any) will be raised to the top of the stack.

If direction is XCB_CIRCULATE_LOWER_HIGHEST, the highest mapped child will be lowered to the bottom of the stack.

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_circulate_window_checked. See xcb-requests(3) for details.

Errors

xcb_value_error_t

The specified direction is invalid.

xcb_window_error_t

The specified window does not exist.

Releases

6 releases since Debian 9 (Stretch); the text changed 4 times.

  1. 9
  2. 10
  3. 11
  4. 12
  5. 13–Arch

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.