Section: Tk Themed Widget (n)
Updated: 8.5
Index Return to Main Contents



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.  


-class     -cursor-takefocus

See the ttk_widget manual entry for details on the standard options.  


[ -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. 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 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.  


pathName cget option
Returns the current value of the specified option. See ttk::widget(n).
pathName configure ?option? ?value option value ...?
Modify or query widget options. See ttk::widget(n).
pathName current ?newIndex?
If newIndex is supplied, sets the combobox value to the element at position newIndex in the list of -values. Otherwise, returns the index of the current value in the list of -values or -1 if the current value does not appear in the list.
pathName get
Returns the current value of the combobox.
pathName identify x y
Returns the name of the element at position x, y. See ttk::widget(n).
pathName instate stateSpec ?script?
Test the widget state. See ttk::widget(n).
pathName set value
Sets the value of the combobox to value.
pathName state ?stateSpec?
Modify or query the widget state. See ttk::widget(n).

The combobox widget also supports the following ttk::entry widget commands (see ttk::entry(n) for details):

bbox  deleteicursor
index insertselection



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.  


ttk::widget(n), ttk::entry(n)  


choice, entry, list box, text box, widget