|
ActiveTcl User Guide |
|
- NAME
- ttk::combobox - text field with popdown selection list
- SYNOPSIS
- ttk::combobox pathName ?options?
- DESCRIPTION
- STANDARD OPTIONS
- -class
- -cursor, cursor, Cursor
- -style
- -takefocus, takeFocus,
TakeFocus
- WIDGET-SPECIFIC
OPTIONS
- -exportselection,
exportSelection, ExportSelection
- -justify, justify,
Justify
- -height, height,
Height
- -postcommand,
postCommand, PostCommand
- -state, state,
State
- -textvariable,
textVariable, TextVariable
- -values, values,
Values
- -width, width,
Width
- WIDGET COMMAND
- pathName
cget option
- pathName
configure ?option? ?value option value
...?
- pathName
current ?newIndex?
- pathName
get
- pathName
identify x y
- pathName
instate stateSpec ?script?
- pathName
set value
- pathName
state ?stateSpec?
- VIRTUAL
EVENTS
- SEE ALSO
- KEYWORDS
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, cursor,
Cursor
- -style
- -takefocus, takeFocus,
TakeFocus
- Command-Line Name: -exportselection
- Database Name: exportSelection
- Database Class: ExportSelection
- Boolean value. If set, the widget selection is linked to the X
selection.
- Command-Line Name: -justify
- Database Name: justify
- Database Class: Justify
- Specifies how the text is aligned within the widget. One of
left, center, or right.
- Command-Line Name: -height
- Database Name: height
- Database Class: Height
- Specifies the height of the pop-down listbox, in rows.
- Command-Line Name: -postcommand
- Database Name: postCommand
- Database Class: PostCommand
- A Tcl script to evaluate immediately before displaying the
listbox. The -postcommand script may specify the
-values to display.
- Command-Line Name: -state
- Database Name: state
- Database Class: 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.
- Command-Line Name: -textvariable
- Database Name: textVariable
- Database Class: 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.
- Command-Line Name: -values
- Database Name: values
- Database Class: Values
- Specifies the list of values to display in the drop-down
listbox.
- Command-Line Name: -width
- Database Name: width
- Database Class: 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 delete icursor
index insert selection
xview
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, ttk::entry
choice, entry, list box, text box, widget
Copyright © 1995-1997 Roger E. Critchlow Jr.
Copyright © 2004 Joe English