widget_toolbar(3tk)

💖 widget_toolbar — the Toolbar Megawidget, bestie edition 💖

okay so this is widget_toolbar from the Various megawidgets crew, living in the widget_toolbar(3tk) manual page. she's a toolbar. she's a megawidget. she's lowkey a snidget. and she is about to make your Tk app look so put together. 🎀

---

✨ NAME ✨

widget_toolbar — Toolbar Megawidget 👑

---

🦋 SYNOPSIS 🦋

package require Tcl 8.4

package require Tk 8.4

package require widget ?3.0?

package require widget::toolbar ?1.0?

widget::toolbar pathname ?options?

getframe

add ?item? ?args?

delete item1 ?item2? ?...?

itemcget symbol option

itemconfigure symbol ?args?

items ?pattern?

remove ?-destroy? item1 ?item2? ?...?

the ?3.0? and ?1.0? and all the ?item? / ?args? question marks are fr fr doing the "this part is optional" thing. she said maybe, maybe not, we'll see. 💅

---

🌸 DESCRIPTION 🌸

so this package hands you a toolbar megawidget — and the original is very extra about calling it a snidget, which is iconic of it. she makes use of the Tile/Ttk themed widget set, so she's themed, she's coordinated, she's not out here clashing with the rest of your UI. no cap.

here's the whole cast of commands, again, because she likes to say it twice:

widget::toolbar pathname ?options?

getframe

add ?item? ?args?

delete item1 ?item2? ?...?

itemcget symbol option

itemconfigure symbol ?args?

items ?pattern?

remove ?-destroy? item1 ?item2? ?...?

not me noticing the SYNOPSIS and the DESCRIPTION are serving the exact same list. she's consistent. we respect that. 🙈

---

🧚 WIDGET OPTIONS 🧚

these are the widget-level ones. the original doesn't give descriptions for them, so I'm not out here making things up — she's just mysterious like that. 😭

• -ipad — a widget option. that's all she wrote, bestie.
• -pad — also a widget option. the girlies stay cryptic.
• -separator — yes, another widget option. slay.

---

⭐ ITEM OPTIONS ⭐

and these ones live at the item level. same deal — the page lists them, the page does not explain them, and I will not be inventing lore.

• -pad — an item option.
• -separator — an item option.
• -sticky — an item option.
• -weight — an item option.

---

🔥 EXAMPLE 🔥

here's the moment. the demo. the main character energy:

package require widget::toolbar ; # or widget::all
set t [widget::toolbar .t]
pack $t -fill x -expand 1
$t add button [button .b -text foo]
$t add separator -pad {2 4}
$t add button [button .c -text bar]

look at her go. buttons, a separator, -fill x -expand 1 so she stretches all the way across like she owns the place. because she does. 💅

---

🫶 BUGS, IDEAS, FEEDBACK 🫶

okay, real talk — this document, and the package it describes, will undoubtedly contain bugs and other problems. that's a direct quote, she's being honest with us, and honestly? growth.

• spotted a bug? report it in the category widget::toolbar of the Tklib Trackers at http://core.tcl.tk/tklib/reportlist.
• got ideas for enhancements for the package and/or the documentation? she wants those too, same place.

please report both. she's asking nicely. 🥺

---

🌈 KEYWORDS 🌈

megawidget, snit, toolbar, widget

---

👑 CATEGORY 👑

Widget

---

and that's the whole page, bestie — brought to you by tklib, version 3.0, serving the widget_toolbar(3tk) manual. go build a toolbar that eats. periodt. 💖✨