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

# Tk\_RestackWindow(3)

Change a window's position in the stacking order

```

```

## NAME

Tk\_RestackWindow - Change a window's position in the stacking order

## SYNOPSIS

```
#include <tk.h>

int
Tk_RestackWindow(tkwin, aboveBelow, other)
```

## ARGUMENTS

- Tk\_Window *tkwin* (in)

  Token for window to restack.

- int *aboveBelow* (in)

  Indicates new position of *tkwin* relative to *other*; must be **Above** or **Below**.

- Tk\_Window *other* (in)

  *Tkwin* will be repositioned just above or below this window. Must be a sibling of *tkwin* or a descendant of a sibling. If NULL then *tkwin* is restacked above or below all siblings.

  ```

  ```

## DESCRIPTION

**Tk\_RestackWindow** changes the stacking order of *window* relative to its siblings. If *other* is specified as NULL then *window* is repositioned at the top or bottom of its stacking order, depending on whether *aboveBelow* is **Above** or **Below**. If *other* has a non-NULL value then *window* is repositioned just above or below *other*.

The *aboveBelow* argument must have one of the symbolic values **Above** or **Below**. Both of these values are defined by the include file \<X11/Xlib.h\>.

## KEYWORDS

above, below, obscure, stacking order