- NAME
- ComboBox
- ComboBox widget
- CREATION
- ComboBox pathName ?option value...?
- OPTIONS from ArrowButton
-background or -bg |
-disabledforeground |
-foreground or -fg |
-state |
- OPTIONS from Entry
-command |
-disabledforeground |
-dragenabled |
-dragendcmd |
-dragevent |
-draginitcmd |
-dragtype |
-dropcmd |
-dropenabled |
-dropovercmd |
-droptypes |
-editable |
-entrybg (see -background) |
-entryfg (see -foreground) |
-exportselection |
-font |
-helptext |
-helptype |
-helpvar |
-highlightbackground |
-highlightcolor |
-highlightthickness |
-insertbackground |
-insertborderwidth |
-insertofftime |
-insertontime |
-insertwidth |
-justify |
-selectbackground |
-selectborderwidth |
-selectforeground |
-show |
-state |
-takefocus |
-text |
-textvariable |
-width |
-xscrollcommand |
- OPTIONS from LabelFrame
-background or -bg |
-borderwidth or -bd |
-disabledforeground |
-foreground or -fg |
-helptext |
-helptype |
-helpvar |
-label (see -text) |
-labelanchor (see -anchor) |
-labelfont (see -font) |
-labelheight (see -height) |
-labeljustify (see -justify) |
-labelwidth (see -width) |
-name |
-padx |
-pady |
-relief |
-side |
-state |
-underline |
-wraplength |
- WIDGET-SPECIFIC OPTIONS
- WIDGET COMMAND
- pathName bind
?arg...?
- pathName cget
option
- pathName configure
?option? ?value option value ...?
- pathName getvalue
- pathName setvalue
index
DESCRIPTION
ComboBox widget enables the user to select a value among a list given by the values option.
The list of possible values can be popped by pressing the ArrowButton or by clicking in the entry
when editable value of the ComboBox is false.
If editable value of the ComboBox is true and the entry has the focus, the user can
press the top and bottom arrow keys to modify its value. If the current value exactly match a value in the list,
then the previous (for top arrow key) or then next (for bottom arrow key) value in the list is displayed.
If the current value match the beginning of a value in the list, then this value is displayed.
If the current value doesnt match anything, then the first value is displayed.
WIDGET-SPECIFIC OPTIONS
- -height
-
Specifies the desired height for the window, in lines. If zero or less, then the desired
height for the window is made just large enough to hold all the elements in the listbox.
- -modifycmd
-
Specifies a Tcl command called when the user modify the value of the ComboBox by selecting it in the listbox or pressing arrow key.
- -postcommand
-
Specifies a Tcl command called before the listbox of the ComboBox is mapped.
- -values
-
Specifies the values to display in the listbox of the ComboBox.
WIDGET COMMAND
- pathName bind
?arg...?
-
Set bindings on the entry widget.
- pathName cget
option
-
Returns the current value of the configuration option given by option.
Option may have any of the values accepted by the creation command.
- pathName configure
?option? ?value option value ...?
-
Query or modify the configuration options of the widget. If no option is specified,
returns a list describing all of the available options for pathName.
If option is specified with no value, then the command returns a list
describing the one named option (this list will be identical to the corresponding
sublist of the value returned if no option is specified). If one or
more option-value pairs are specified, then the command modifies the given widget
option(s) to have the given value(s); in this case the command returns an empty string.
Option may have any of the values accepted by the creation command.
Read-only options are not be modified.
- pathName getvalue
-
Returns the index of the current text of the ComboBox in the list of values,
or -1 if it doesn't match any value.
- pathName setvalue
index
-
Set the text of the ComboBox to the value indicated by index in the list of values.
index may be specified in any of the following forms:
-
last
-
Specifies the last element of the list of values.
- first
-
Specifies the first element of the list of values.
-
next
-
Specifies the element following the current (ie returned by getvalue) in the list
of values.
- previous
-
Specifies the element preceding the current (ie returned by getvalue) in the list
of values.
-
@number
-
Specifies the integer index in the list of values.
BINDINGS
When Entry of the ComboBox has the input focus, it has the following bindings, in addition
to the default Entry bindings:
- Page up set the value of the ComboBox to the first value.
- Page down set the value of the ComboBox to the last value.
- Arrow up set the value of the ComboBox to the previous value.
- Arrow down set the value of the ComboBox to the next value.
If the listbox is not mapped and ComboBox is not editable or disabled,
mouse button 1 on the Entry cause the listbox to popup, as if the user press the ArrowButton.