combobox(3tcl)
NAME
ttk::combobox - text field with popdown selection list
SYNOPSIS
ttk::combobox pathName ?options? -class -cursor -takefo- cus -style
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 specify 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 averagesize characters of the widget's font.
DESCRIPTION
A 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.
WIDGET COMMAND
- pathName cget option
- Returns the current value of the specified option. See widget(n).
- pathName configure ?option? ?value option value ...?
- Modify or query widget options. See 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, or the empty string if the coordinates are outside the window.
- pathName instate statespec ?script?
- Test the widget state. See widget(n).
- pathName set value
- Sets the value of the combobox to value.
- pathName state ?stateSpec?
- Modify or query the widget state. See widget(n).
- The combobox widget also supports the following entry widget commands
(see 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. This event is
generated after the listbox is unposted.
SEE ALSO
- widget(n), entry(n)