combobox - Create and manipulate combination box widgets
combobox pathName ?options?
itk::Widget <- LabeledWidget <- Entryfield <- Combobox
background borderWidth cursor justify
options.
hscrollmode textBackground textFont vscrollmode
inherited options.
show
option.
childSitePos command fixed focusCommand
ited options.
labelBitmap labelFont labelImage labelMargin
inherited options.
button in a normal (not depressed) state. Acceptable values are raised, sunken, flat, ridge, and groove. Sunken is discouraged as this is the relief used to indicate a depressed state. This option has no effect on simple Comboboxes. The default is raised.
which determines whether insertions into the entry field, whether
from the keyboard or programmatically via the insert method, are
automatically completed with the first matching item from the
listbox. The default is true.
forms acceptable to Tcl_GetBoolean. If true, the Combobox will be
a dropdown style widget which displays an entry field and an
arrow button which when activated will pop up a scrollable list
of items. If false, a simple Combobox style will be used which
has an entry field and a scrollable list beneath it which is
always visible. Both styles allow an optional label for the entry
field area. The default is true.
by the user. If true the user can add items to the combobox by
entering text into the entry area and then pressing Return. If
false, the list of items is non-editable and can only be changed
by calling the insert or delete methods. (The value in the entry
field can still be modified by selecting from the list.) Given
in any of the forms acceptable to Tcl_GetBoolean. The default is
true.
in drop-down comboboxes. It can be either global or local. The
default is local.
arrow button for a dropdown Combobox given in any of the forms acceptable to Tk_GetPixels. This option has no effect on a simple
value may have any of the forms acceptable to Tk_GetCursor. The
default is arrow.
the listbox area is selected. The item will be selected in the
list, the listbox will be removed if it is a dropdown Combobox,
and the selected item's text will be inserted into the entry
field before the -selectioncommand proc is called. The default is
{}.
either normal or disabled. If the Combobox is disabled, no text
can be entered into the entry field, no selection can be made in
the listbox, and the arrowBtn component is disabled. The default
is normal.
the combobox list. If true, then duplicates are not allowed to be
inserted. If false, a duplicate entry causes selection of the
item. Given in any of the forms acceptable to Tcl_GetBoolean. The
default is true.
_________________________________________________________________
an optional associated label and a scrollable list. When an item is selected in the list area of a Combobox, its value is then displayed in the entry field text area. Functionally similar to an Optionmenu, the Combobox adds (optional) list scrolling and (optional) item editing and inserting capabilities.
-dropdown option): dropdown and simple. The dropdown style adds an arrow button to the right of the entry field which when acti- vated will pop up (and down) the scrolled listbox beneath the entry field. The simple (non-dropdown) Combobox permanently dis- plays the listbox beneath the entry field and has no arrow but- ton. Either style allows an optional entry field label.
pathName. This command may be used to invoke various operations on the widget. It has the following general form:
pathName option ?arg arg ...?
ated methods.
curselection index see size
ated methods.
associated methods.
pathName cget option
option. Option may have any of the values accepted by the com-
bobox command.
pathName clear ?component?
values are list, or entry. With no component specified, both are
cleared.
pathName configure ?option? ?value option value ...?
option is specified, returns a list describing all of the avail-
able options for pathName (see Tk_ConfigureInfo for information
on the format of this list). 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 combobox command.
pathName delete component first ?last?
entry. If a list item to be removed is currently selected (dis-
played in the entry field area), the entry field will be cleared.
pathName get ?index?
field area. With a single argument, returns the contents of the
listbox item at the indicated index.
pathName insert component index element ?element element ...?
entry, just before the element given by index.
pathName selection option first ?last?
contents of the entry field component to the value of the
selected item. See the «listbox» manual entry for more details on
parameter options.
the contents of this item.
select from. For dropdown Comboboxes, this component is hidden until the user pops it up by pressing on the arrow button to the right of the entry component. For simple Comboboxes this compo- nent is always visible just beneath the entry component.
ponent items - the Scrolledlistbox and Entryfield. However it
also adds these:
[1] Button-1 mouse press on the arrow key of a dropdown Combobox
causes the list to be popped up. If the combobox is non-editable,
a Button-1 press on the entry field area will also pop up the
list.
[2] Button-1 mouse press anywhere on the display removes a drop-
down listbox which has been popped up, unless the keypress is
upon one of the Combobox scrollbars which scrolls the list. If it
is pressed upon an item in the list area, that item will be
selected before the list is removed.
[3] Button-3 mouse press on the arrow key of a dropdown Combobox
causes the next item to be selected. Shift-Button-3 causes the
previous item to be selected.
[4] Escape keypress removes a dropdown list which has been popped
up.
[5] The <space> and <Return> keystrokes select the current item.
[6] Up and Down arrow keypresses from the entry field and arrow
button component cause the previous and next items in the listbox
to be selected respectively. Ctl-P and Ctl-N are similarly mapped
for emacs emulation.
[7] Entry field and arrow button component Shift-Up and Shift-
bobox. The arrow button component also maps <Return> and <space> similarly.
proc selectCmd {} {
puts stdout «[.cb2 getcurselection]"
}
#
# Non-editable Dropdown Combobox
#
combobox .cb1 -labeltext Month: \
-selectioncommand {puts «selected: [.cb1 getcurselection]"} \
-editable false -listheight 185 -popupcursor hand1
.cb1 insert list end Jan Feb Mar Apr May June Jul Aug Sept Oct Nov Dec
#
# Editable Dropdown Combobox
#
combobox .cb2 -labeltext «Operating System:» -selectioncommand selectCmd
.cb2 insert list end Linux HP-UX SunOS Solaris Irix
.cb2 insert entry end L
pack .cb1 -padx 10 -pady 10 -fill x
pack .cb2 -padx 10 -pady 10 -fill x
combobox, entryfield, scrolledlistbox, itk::Widget, entry, list- box, widget, iwidgets