Tcl/Tk in a Nutshell

Name

CheckList

tixCheckList pathName [option value...]

The tixCheckList command creates a new tixCheckList mega-widget named pathName. The tixCheckList class is derived from the tixTree class. It displays a hierarchical list of items that can be selected by the user. The status of an item can be one of four possible values: on (indicated by a check bitmap), off (indicated by a cross bitmap), default (indicated by a gray box bitmap), or none (no bitmap). Items with on, off, and default status may be selected. The default status for an item is none.

Widget-Specific Options

-browsecmd tclCommand (browseCmd, BrowseCmd)

Command to call whenever the user browses an entry (usually by a single click). The pathname of the entry is appended as an argument.

-command tclCommand (command, Command)

Command to call whenever the user invokes an entry (usually by a double click). The pathname of the entry is appended as an argument.

-radio boolean (radio, Radio)

Whether only one item at a time can be selected.

Subwidgets

hlist

The tixHList mega-widget that displays the tixCheckList. Entries to the tix- CheckList are added directly to the hlist subwidget. Entries must be display items of type imagetext. Once an entry is added, the tixCheckList setstatus command should be called to set the entry’s status:

tixCheckList .c
     .c subwidget hlist add choice1 -itemtype imagetext
          -text "Choice 1"
     .c setstatus choice1 on

hsb

The horizontal scrollbar widget.

vsb

The vertical scrollbar widget.

Methods

pathName getselection [status ...