ttk::sizegrip(3tk)

✨ ttk::sizegrip — the little grippy corner bestie ✨

okay so like, welcome to the ttk::sizegrip manual page (that's the 3tk one, section 3, Tk-flavored, iykyk 💅). This is a Tk Themed Widget, and she's here to let your users yank their window bigger from the corner. Iconic behaviour, truly.

---

🌸 NAME 🌸

ttk::sizegrip — the bottom-right corner resize widget, aka the grow box 🎀

---

✨ SYNOPSIS ✨

ttk::sizegrip pathName ?options?

---

💖 DESCRIPTION 💖

A ttk::sizegrip widget (everyone also calls her a grow box, no cap) lets the user resize the toplevel window she lives inside by pressing and dragging on the grip. That's it. That's her whole job. And she ate. 🔥

---

🫶 STANDARD OPTIONS 🫶

• -class
• -cursor
• -style
• -takefocus

Go read the ttk_widget manual entry for the full deets on these standard options, bestie — they're not re-explained here.

---

👑 WIDGET COMMAND 👑

Sizegrip widgets support the standard commands cget, configure, identify element, instate, state and style — see ttk::widget for all of those. Periodt. 💅

---

🌈 PLATFORM-SPECIFIC NOTES 🌈

On macOS, toplevel windows automatically come with a built-in size grip by default. So adding a ttk::sizegrip there is harmless — the built-in grip will just mask your widget. She's still there, just, like, behind the curtain. 🙈

---

🦋 EXAMPLES 🦋

Using pack:

pack [ttk::frame $top.statusbar] -side bottom -fill x
pack [ttk::sizegrip $top.statusbar.grip] -side right -anchor se

Using grid:

grid [ttk::sizegrip $top.statusbar.grip] \
    -row $lastRow -column $lastColumn -sticky se
# ... optional: add vertical scrollbar in $lastColumn,
# ... optional: add horizontal scrollbar in $lastRow

---

💀 BUGS 💀

If the containing toplevel's position was specified relative to the right or bottom of the screen (like wm geometry ... wxh-x-y instead of wm geometry ... wxh+x+y), the sizegrip widget will not resize the window. She simply cannot. She refuses. 😭

Also: ttk::sizegrip widgets only support "southeast" resizing. That's the vibe. That's the only vibe.

---

🎀 STYLING OPTIONS 🎀

The class name for a ttk::sizegrip is TSizegrip.

TSizegrip styling options you can configure with ttk::style are:

• -background color

Some options are only available for specific themes, so don't come for her if one's missing.

See the ttk::style manual page for info on how to configure ttk styles. 💜

---

🌟 SEE ALSO 🌟

ttk::widget(3tk)

---

🔥 KEYWORDS 🔥

widget, sizegrip, grow box

---

k bye ily, this was Tk 8.5 of the ttk::sizegrip(3tk) page — go forth and resize, main character 🫶✨