---
name: "xcb_shape_rectangles"
section: "3"
platform: "linux"
package: "libxcb"
version: "1.17.0-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/xcb_shape_rectangles"
---

# xcb\_shape\_rectangles(3)

## NAME

xcb\_shape\_rectangles -

## SYNOPSIS

**#include \<xcb/shape.h\>**

### Request function

xcb\_void\_cookie\_t **xcb\_shape\_rectangles**(xcb\_connection\_t \**conn*, xcb\_shape\_op\_t *operation*, xcb\_shape\_kind\_t *destination\_kind*, uint8\_t *ordering*, xcb\_window\_t *destination\_window*, int16\_t *x\_offset*, int16\_t *y\_offset*, uint32\_t *rectangles\_len*, const xcb\_rectangle\_t \**rectangles*);\

## REQUEST ARGUMENTS

- *conn*

  The XCB connection to X11.

- *operation*

  TODO: NOT YET DOCUMENTED.

- *destination\_kind*

  TODO: NOT YET DOCUMENTED.

- *ordering*

  TODO: NOT YET DOCUMENTED.

- *destination\_window*

  TODO: NOT YET DOCUMENTED.

- *x\_offset*

  TODO: NOT YET DOCUMENTED.

- *y\_offset*

  TODO: NOT YET DOCUMENTED.

- *rectangles\_len*

  TODO: NOT YET DOCUMENTED.

- *rectangles*

  TODO: NOT YET DOCUMENTED.

## DESCRIPTION

## 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\_shape\_rectangles\_checked*. See **[xcb-requests(3)](/xcb-requests/3.md)** for details.

## ERRORS

This request does never generate any errors.

## SEE ALSO

## AUTHOR

Generated from shape.xml. Contact xcb@lists.freedesktop.org for corrections and improvements.