Tk_SetGrid(3tk)

💖 Tk_SetGrid — bestie, let's talk grid control 💖

okay so this is the Tk Library Procedures page for Tk_SetGrid and Tk_UnsetGrid, and it's literally all about controlling the grid for interactive resizing. no cap. ✨

---

🌸 SYNOPSIS 🌸

#include <tk.h>

Tk_SetGrid(tkwin, reqWidth, reqHeight, widthInc, heightInc)

Tk_UnsetGrid(tkwin)

---

🎀 ARGUMENTS 🎀

• Tk_Window tkwin (in) — bestie, this is just the token for the window. your lil window ID. that's it. 🫶
• int reqWidth (in) — the width in grid units that matches up with the pixel dimension tkwin requested via Tk_GeometryRequest. like, "how many grid units wide do you think you are, babe."
• int reqHeight (in) — same energy as reqWidth but vertical: the height in grid units corresponding to the pixel dimension tkwin requested via Tk_GeometryRequest. 👑
• int widthInc (in) — width of ONE grid unit, in pixels. the smallest step. the atom of the grid. 💅
• int heightInc (in) — height of one grid unit, in pixels. vertical atom. iconic.

---

✨ DESCRIPTION ✨

so Tk_SetGrid turns on gridded geometry management for tkwin's toplevel window and tells it exactly how the grid is shaped. 🌈

Tk_SetGrid is typically invoked by a widget when its setGrid option is true. (yes, the widget is the one calling, it's giving main character energy.)

what it does: it restricts interactive resizing of tkwin's toplevel window so that the space allocated to the toplevel is equal to its requested size, plus or minus even multiples of widthInc and heightInc. so you can only snap in even grid steps, no chaotic in-between sizes, periodt. 💅

and ALSO — the reqWidth and reqHeight values get passed to the window manager so it can report the window's size in grid units during interactive resizes. the WM knows the grid now. it's informed. it's in the group chat. 🦋

heads up bestie: if tkwin's configuration changes (e.g. the size of a grid unit changes), then the widget should invoke Tk_SetGrid again with the new information. don't just sit there with stale numbers, that's not the vibe. 😭

Tk_UnsetGrid cancels gridded geometry management for tkwin's toplevel window. goodbye grid, we hardly knew ye. 🙈

the big rule: for each toplevel window there can be at most one internal window with gridding enabled. so if Tk_SetGrid or Tk_UnsetGrid is invoked when some other window is already controlling gridding for tkwin's toplevel, the calls for the new window have no effect. 💀 yeah. nothing happens. the OG keeps the crown. 👑

for extra lore on gridded geometry management, go see the wm manual entry. iykyk. 📖

---

⭐ KEYWORDS ⭐

grid, window, window manager

---

that's the whole page, bestie — no crumbs left behind 🍓

this lil masterpiece comes to you from Tk, version 4.0, dated Tk_SetGrid(3tk) — mwah, slay, go resize something beautifully 💖✨🎀