iwidgets::selectiondialog(1)

✨ iwidgets::selectiondialog — the [incr Widgets] era 💅

okay bestie, sit down, hydrate, and let me tell you about iwidgets::selectiondialog — a whole selection dialog widget you can create and manipulate. yes it's giving vintage, yes it still slays. 🎀

---

🌸 NAME 🌸

iwidgets::selectiondialog — make a selection dialog widget and then boss it around 💖

---

🦋 SYNOPSIS 🦋

iwidgets::selectiondialog pathName ?options?

---

👑 INHERITANCE 👑

the family tree is long, bestie, it's giving royal lineage:

itk::Toplevel <- iwidgets::Shell <- iwidgets::Dialogshell <- iwidgets::Dialog <- iwidgets::Selectiondialog

---

✨ STANDARD OPTIONS ✨

these are the classics, the ones everybody knows:

• activeBackground
• background
• borderWidth
• cursor
• exportSelection
• foreground
• highlightColor
• highlightThickness
• insertBackground
• insertBorderWidth
• insertOffTime
• insertOnTime
• insertWidth
• selectBackground
• selectBorderWidth
• selectForeground

see the options manual entry for the deets on all of the above, no cap 📖

---

🧚 ASSOCIATED OPTIONS 🧚

okay so these are the options this widget borrows from its little friends:

• textBackground, textFont — from the entryfield widget

see the entryfield widget manual entry for the details on those 🫶

• labelFont — from the labeledwidget

see the labeledwidget widget manual entry for the details on that one 💜

• activeRelief, elementBorderWidth, jumptroughColor — from the scrollbar widget class

see the scrollbar widget class manual entry for the details on those ✨

• textBackground, textFont — yep, again, this time from the scrolledlistbox widget class

see the scrolledlistbox widget class manual entry for the details on those 🌈

• childsitepos, itemsCommand, itemsLabel, itemsOn, selectionCommand, selectionLabel, selectionOn — from the selectionbox widget

see the selectionbox widget manual entry for the details on those 🍓

---

🎀 INHERITED OPTIONS 🎀

things it got from its ancestors (nepo baby behavior, honestly):

• buttonBoxPadX, buttonBoxPadY, buttonBoxPos, padX, padY, separator, thickness — from dialogshell

see the dialogshell widget manual entry for the details on those 💅

• height, master, modality, width — from shell

see the shell widget manual entry for the details on those 💖

• title — from Toplevel

see the Toplevel widget manual entry for the details on that one ⭐

---

💜 DESCRIPTION 💜

iwidgets::selectiondialog creates a selection box similar to the OSF/Motif standard selection dialog composite widget. literally iconic, it ate. 🫶

the selectiondialog is derived from the Dialog class, and it's composed of a selectionbox plus commands to manipulate the dialog buttons. periodt. 💅

---

🔥 METHODS 🔥

the iwidgets::selectiondialog command creates a brand new Tcl command whose name is pathName. you use that command to invoke various operations on the widget. general form goes like this:

pathName option ?arg arg ...?

option and the args decide exactly what the command does. here's what's on the menu for selectiondialog widgets: 🍓

🌟 ASSOCIATED METHODS 🌟

• childsite, clear, get, insert, selectitem — from the selectionbox widget

see the selectionbox widget manual entry for the details on those ✨

• curselection, delete, index, nearest, scan, selection, size — from the listbox widget

see the listbox widget manual entry for the details on those 🦋

🌸 INHERITED METHODS 🌸

• add, buttonconfigure, defaulthide, invoke, show — from the buttonbox widget

see the buttonbox widget manual entry for the details on those 💜

• activate, center, deactivate — from the shell widget

see the shell widget manual entry for the details on those 🎀

👑 WIDGET-SPECIFIC METHODS 👑

• pathName cget option — returns the current value of the configuration option named by option. option can be any of the values that the iwidgets::selectiondialog command accepts. 💖
• pathName configure ?option? ?value option value ...? — query or modify the configuration options of the widget. if you don't give an option, it returns a list describing all the available options for pathName (see Tk_ConfigureInfo for the format of that list). if you give option with no value, it returns a list describing just that one named option — and that list is identical to the matching sublist of what you'd get with no option at all. if you give one or more option-value pairs, it modifies the given widget option(s) to have the given value(s), and in that case the command returns an empty string. option can be any of the values that the iwidgets::selectiondialog command accepts. 🫶

---

🧁 COMPONENTS 🧁

• Name: selectionbox
• Class: Selectionbox

the selectionbox component is the selection box for the selection dialog. see the selectionbox widget manual entry for details on the selectionbox component item. 🌸

---

🌈 EXAMPLE 🌈

okay here's the whole vibe, copy-paste and go:

package require Iwidgets 4.0
iwidgets::selectiondialog .sd
.sd activate

---

💖 AUTHOR 💖

Mark L. Ulferts — legend behavior, we thank him for his service 🫡💅

---

⭐ KEYWORDS ⭐

selectiondialog, selectionbox, dialog, dialogshell, shell, widget

---

and that's the whole page, bestie 🎀 this came out of the Tk corner of the world, dated with the classic iwidgets::selectiondialog(1) tag at the bottom — go forth and select some stuff, you're literally the main character 💅✨🦋