Tk_RestackWindow(3tk)

✨ Tk_RestackWindow ✨

okay bestie, buckle up, we're doing a Tk Library Procedures page today and it's literally called Tk_RestackWindow 💅 this one is about moving a window around in the stacking order, which is just fancy speak for "who's on top of who" 🦋 no cap.

---

🌸 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) — the token for the window you wanna restack, periodt 👑
• int aboveBelow (in) — tells you where tkwin is gonna land relative to other. it has to be either Above or Below, no in-between vibes allowed 🚫
• Tk_Window other (in) — tkwin gets 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 its siblings 🌈

---

🦋 DESCRIPTION 🦋

so like, Tk_RestackWindow changes the stacking order of a window relative to its siblings 💫

if other is NULL, the window gets repositioned at the top or the bottom of its stacking order — which one depends on whether aboveBelow is Above or Below 👀

if other has a non-NULL value, then the window gets repositioned just above or just below other. simple as that bestie 🫶

the aboveBelow argument has to be one of the symbolic values Above or Below. both of those are defined by the include file <X11/Xlib.h> — so yes, you gotta have that in your life already 📚✨

---

🔥 KEYWORDS 🔥

above, below, obscure, stacking order

---

and that's the whole page, no notes 💜 this gem lives in the Tk library procedures docs — the header up top reads Tk_RestackWindow(3tk) / Tk Library Procedures, and the footer signs off with source Tk and Tk_RestackWindow(3tk) 🎀 go forth and restack, you icon 👑💖