Documentation generated from fossil trunk
ttk::combobox -
text field with popdown selection list
ttk::combobox pathName ?options?
A ttk::combobox combines a text field with a pop-down list of values; the user may select the value of the text field from among the values in the list.
| Name | Database name | Database class |
|---|---|---|
| -exportselection | exportSelection | ExportSelection |
| Boolean value. If set, the widget selection is linked to the X selection. | ||
| -justify | justify | Justify |
| Specifies how the text is aligned within the widget. Must be one of left, center, or right. | ||
| -height | height | Height |
| Specifies the height of the pop-down listbox, in rows. | ||
| -postcommand | postCommand | PostCommand |
| A Tcl script to evaluate immediately before displaying the listbox. The -postcommand script may specify the -values to display. | ||
| -state | state | State |
| One of normal, readonly, or disabled. In the readonly state, the value may not be edited directly, and the user can only select one of the -values from the dropdown list. In the normal state, the text field is directly editable. In the disabled state, no interaction is possible. | ||
| -textvariable | textVariable | TextVariable |
| Specifies the name of a global variable whose value is linked to the widget value. Whenever the variable changes value the widget value is updated, and vice versa. | ||
| -values | values | Values |
| Specifies the list of values to display in the drop-down listbox. | ||
| -width | width | Width |
| Specifies an integer value indicating the desired width of the entry window, in average-size characters of the widget's font. | ||
The following subcommands are possible for combobox widgets:
The combobox widget also supports the following ttk::entry widget subcommands (see ttk::entry(n) for details):
The combobox widget also supports the following generic ttk::widget widget subcommands (see ttk::widget(n) for details):
The combobox widget generates a <<ComboboxSelected>> virtual event when the user selects an element from the list of values. If the selection action unposts the listbox, this event is delivered after the listbox is unposted.