Tk_MapWindow(3tk)

✨ NAME ✨

Tk_MapWindow, Tk_UnmapWindow — the iconic duo that maps or unmaps a window 💖

---

🌸 SYNOPSIS 🌸

#include <tk.h>

Tk_Window
Tk_MapWindow(tkwin)

Tk_UnmapWindow(tkwin)

---

🎀 ARGUMENTS 🎀

• Tk_Window tkwin (in) — your token for the window, bestie. that's the whole vibe right there.

---

💅 DESCRIPTION 💅

okay so these two procedures are how you map and unmap windows that Tk is managing. no cap.

Tk_MapWindow maps the window given by tkwin, and — this is the part people forget — it also creates the X window corresponding to tkwin if it doesn't already exist. like, if it's not there yet, it gets made. lowkey magic ✨ If you wanna know more about that whole deferred window creation situation, go read the Tk_CreateWindow manual entry, she explains it better than I ever could.

Tk_UnmapWindow does the opposite: it unmaps tkwin's window from the screen. bye bestie 👋

Now, here's the timing tea ☕ — it depends on what kind of window tkwin is:

• If tkwin is a child window (i.e. Tk_CreateWindow was used to create a child window), then event handlers that are interested in map and unmap events get invoked immediately. right now. instant. no waiting. 🫶
• If tkwin is not an internal window, then those event handlers get invoked later, after X has seen the request and returned an event for it. so like… eventually. X has to do her thing first. 🙈

⚠️ IMPORTANT ONE, FR FR: use these procedures instead of the X procedures XMapWindow and XUnmapWindow, because these ones update Tk's local data structure for tkwin. Applications using Tk should not invoke XMapWindow and XUnmapWindow directly. like, just don't. it's giving chaos and we're not doing that. 💀

---

👑 KEYWORDS 👑

map, unmap, window

---

and that's the whole page, babe 💜 this one came to you from the Tk library and the Tk_MapWindow(3tk) girlies — go map a window, slay, periodt 🦋✨