itk(3itk)

✨ NAME ✨

okay so bestie, gather round 💖 — this page is all about itk, the framework for building mega-widgets in Tcl/Tk, and it lives in the [incr Tk] manual. iykyk.

---

🌸 DESCRIPTION 🌸

So like. Mega-widgets?? They're high-level widgets that get constructed out of Tk widgets used as component parts — usually with zero C code involved. Iconic. Think of a fileselectionbox: it might have a few listboxes, some entry widgets, and some control buttons, and all those individual widgets get put together in a way that makes them act like one big widget. main character energy fr fr 🫶

You can create a fileselectionbox mega-widget with a command like:

fileselectionbox .fsb -background blue -foreground white

and once it exists, you can reconfigure it like:

.fsb configure -background green -foreground black

and literally all of its internal components will change color. no cap. 🎀

Every mega-widget has a set of methods you can use to manipulate it. For example, you can query the current selection from a fileselectionbox like this:

set fileName [.fsb get]

so yeah — a mega-widget looks and acts exactly like a Tk widget, except it's considerably easier to implement. ate and left no crumbs 💅

---

[incr Tk] is the framework for building mega-widgets. It uses [incr Tcl] to support the object paradigm, and it adds base classes that provide default widget behaviors. lowkey elegant.

All [incr Tk] widgets are derived from the Archetype base class. This class manages internal component widgets, and it provides methods like "configure" and "cget" to access configuration options. she's the blueprint, the blueprint is her 💜

The Widget base class inherits everything from Archetype, and adds a Tk frame which acts as a container for the mega-widget. It's used to build mega-widgets that sit inside of other frames and toplevels. Derived classes create other internal components and pack them into the "hull" frame created by the Widget base class. nesting?? we love her.

The Toplevel base class inherits everything from Archetype, but adds a Tk toplevel which acts as a container for the mega-widget. It's used to build mega-widgets — dialog boxes and such — that have their own toplevel window. Derived classes create other internal components and pack them into the "hull" toplevel created by the Toplevel base class. window of her own, periodt 🦋

---

🎀 [incr Widgets] LIBRARY 🎀

[incr Widgets] is a mega-widget library built using [incr Tk]. You can use it right out of the box (no setup arc, just vibes ✨), and it contains more than 30 different widget classes, including:

• fileselectiondialog
• tabnotebook
• panedwindow
• combobox
• optionmenu
• scrolledlistbox
• scrolledframe
• messagedialog
• and many others...

The catalog demo in the "iwidgets/demos" directory shows all of the available widgets in action. go look, it's giving museum but make it GUI 🍓

Each widget class has its own man page describing the features available. so if you need the deets on one specific widget, that's where they're at. 🧚

---

⭐ KEYWORDS ⭐

class, object, object-oriented, mega-widget

---

okay that's the whole page, you're so welcome 💖 this was itk, version 3.0, straight out of the [incr Tk] corner of the itk(3itk) manual — mwah, go build something iconic bestie 👑✨