Tk_RestackWindow(3)

🎀 NAME 🎀

Tk_RestackWindow(3) — okay so this is from the Tk Library Procedures, and it does exactly one iconic thing: Change a window's position in the stacking order. That's the whole name vibe. 💅

---

✨ SYNOPSIS ✨

#include <tk.h>

int
Tk_RestackWindow(tkwin, aboveBelow, other)

---

🫶 ARGUMENTS 🫶

• Tk_Window tkwin (in) — token for the window you're restacking, bestie. It's the main character here.
• int aboveBelow (in) — tells everyone where tkwin should land relative to other; it must be Above or Below. No other values, periodt.
• Tk_Window other (in) — Tkwin will be repositioned just above or just below this window. It must be a sibling of tkwin or a descendant of a sibling. If it's NULL, then tkwin gets restacked above or below all siblings. 💀

---

🌸 DESCRIPTION 🌸

Tk_RestackWindow changes the stacking order of window relative to its siblings. Lowkey its whole job.

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>. That's not me guessing, that's literally the manual, iykyk. 🧚

---

👑 KEYWORDS 👑

above, below, obscure, stacking order

Yes, obscure is really one of the keywords. Not me being dramatic for once. 💜

---

source/version: Tk 🌈 — page Tk_RestackWindow(3), and the footer’s date slot is blank, so no invented date, bestie. 🫶💖