tixCheckList(n)

✨ tixCheckList(n) ✨

bestie, welcome to the tixCheckList(n) page from Tix Built-In Commands — it’s giving widget-manual realness, and we’re gonna get through every flag together 💖

---

✨ NAME ✨

okay so tixCheckList is literally here to create and manipulate tixCheckList widgets 🎀

🛠 SYNOPSIS 🛠

tixCheckList pathName ?options?

👑 SUPER-CLASS 👑

The TixCheckList class is derived from the TixTree class and inherits all the commands, options and subwidgets of its super-class. slay, genetics 💅

🌈 STANDARD OPTIONS 🌈

TixCheckList supports all the standard options of a frame widget. See the options(n) manual entry for details on the standard options. go read that one too, bestie, it’s the lore.

🎀 WIDGET-SPECIFIC OPTIONS 🎀

• -browsecmd browseCmd — Specifies a command to call whenever the user browses on an entry (usually by single-clicking on the entry). The command is called with one argument, the pathname of the entry.
• -command command — Specifies a command to call whenever the user activates an entry (usually by double-clicking on the entry). The command is called with one argument, the pathname of the entry.
• -radio radio — A Boolean value. If set to true, the user can select at most one item at a time; if set to false, the user can select as many items as possible. one-at-a-time mode vs. collect-the-whole-set mode, iykyk.

🦋 SUBWIDGETS 🦋

• Name: hlist — Class: TixHList. The hierarchical listbox that displays the CheckList. main character subwidget energy.
• Name: hsb — Class: Scrollbar. The horizontal scrollbar subwidget.
• Name: vsb — Class: Scrollbar. The vertical scrollbar subwidget.

---

🌸 DESCRIPTION 🌸

The tixCheckList command creates a new window (given by the pathName argument) and makes it into a CheckList widget. Additional options, described above, may be specified on the command line or in the option database to configure aspects of the CheckList widget such as its cursor and relief. customization era, no cap.

The CheckList widget displays a list of items to be selected by the user. CheckList acts similarly to the Tk checkbutton or radiobutton widgets, except it is capable of handling many more items than checkbuttons or radiobuttons. so many items, bestie — it ate.

The items are contained in the hlist subwidget. Each item may be in one of the following status: on (indicated by a check bitmap), off (indicated by a cross bitmap), default (indicated by a gray box bitmap) or none, in which case the item will not be accompanied by a bitmap. The items whose status is on, off or default are called the selectable items and can be checked or crossed by the user. All selectable entries must be of the type imagetext.

The items whose status is none cannot be checked or crossed by the user; usually they are included in the hlist subwidget only for explanation purposes or as separators. little informational vibes only.

Initially, all the items have a none status. To make an item selectable, you can call the setstatus command to change its status (see below).

Notice that CheckList is a subclass of the TixTree widget and thus is capable of displaying a hierarchy of selectable entries. When necessary, you can call the setmode method (see TixTree(n)) to define the hierarchical structure of the selectable entries. tree hierarchy slay.

💅 WIDGET COMMANDS 💅

The tixCheckList command creates a new Tcl command whose name is the same as the path name of the CheckList's window. This command may be used to invoke various operations on the widget. It has the following general form:

pathName option ?arg arg ...?

PathName is the name of the command, which is the same as the CheckList widget's path name. Option and the args determine the exact behavior of the command. The following commands are possible for CheckList widgets:

• pathName getselection ?status? — Returns a list of items whose status matches status. If status is not specified, the list of items in the "on" status will be returned. default behavior stays defaulting to on, periodt.
• pathName getstatus entryPath — Returns the current status of entryPath.
• pathName setstatus entryPath status — Sets the status of entryPath to be status. A bitmap will be displayed next to the entry when its status is on, off or default.
• pathName subwidget name ?args? — When no options are given, this command returns the pathname of the subwidget of the specified name. When options are given, the widget command of the specified subwidget will be called with these options. subwidgetception, but make it useful.

🔥 EXAMPLE 🔥

This example creates several choices for the user to select. copy-paste-ready, bestie.

set c [tixCheckList .c]
$c subwidget hlist add choice1 -itemtype imagetext -text Choice1
$c subwidget hlist add choice2 -itemtype imagetext -text Choice2
$c subwidget hlist add choice3 -itemtype imagetext -text Choice3
$c setstatus choice1 on
$c setstatus choice2 off
$c setstatus choice3 off
pack $c

🖱 BINDINGS 🖱

The basic mouse and keyboard bindings of the CheckList widget are the same as the bindings of the TixTree widget.

In addition, the status of the entries in the CheckList are toggled under the following conditions:

• [1] — When the user presses the mouse button over an entry. clicky click.
• [2] — When the user presses the space key over an entry.
• [3] — When the user presses the Return key over an entry. keyboard girlies rise.

🦋 KEYWORDS 🦋

Tix(n), tixHList(n), tixTree(n)

---

okay bye bestie 💖 — source/version: Tix 4.0; section/page: tixCheckList(n); date: not shown in the original footer, so no invented calendar lore, periodt 🫶