ttk::combobox(n) Tk Themed Widget ttk::combobox(n)
__________________________________________________________________________________________________________________________________________________
NAME
ttk::combobox - text field with popdown selection list
SYNOPSIS
ttk::combobox pathName ?options?
_________________________________________________________________
DESCRIPTION
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.
STANDARD OPTIONS
-class -cursor -takefocus
-style
See the ttk_widget manual entry for details on the standard options.
WIDGET-SPECIFIC OPTIONS
[-exportselection exportSelection] Boolean value. If set, the widget selection is linked to the X selection. [-justify justify] Specifies
how the text is aligned within the widget. One of left, center, or right. [-height height] Specifies the height of the pop-down listbox,
in rows. [-postcommand postCommand] A Tcl script to evaluate immediately before displaying the listbox. The -postcommand script may spec-
ify the -values to display. [-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] 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] Specifies
the list of values to display in the drop-down listbox. [-width width] Specifies an integer value indicating the desired width of the
entry window, in average-size characters of the widget's font.
WIDGET COMMAND
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 delete icursor index insert selection xview
VIRTUAL EVENTS
The combobox widget generates a <<ComboboxSelected>> virtual event when the user selects an element from the list of values. If the selec-
tion action unposts the listbox, this event is delivered after the listbox is unposted.
SEE ALSO
ttk::widget(n), ttk::entry(n)
KEYWORDS
choice, entry, list box, text box, widget
Tk 8.5 ttk::combobox(n)