ActiveTcl User Guide
| |
ActiveTcl User Guide
|
|
iwidgets::combobox - Create and manipulate combination box wid-
gets
iwidgets::combobox pathName ?options?
itk::Widget <- iwidgets::LabeledWidget <-
iwidgets::Entryfield <- iwidgets::Combobox
background borderWidth cursor justify exportSelection foreground highlightColor highlightThickness
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.
_________________________________________________________________
widget with an optional associated label and a scrollable list.
value is then displayed in the entry field text area. Function- ally 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.
name is 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 iwid- gets::combobox 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 iwidgets::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.
package require Iwidgets 4.0
proc selectCmd {} {
puts stdout «[.cb2 getcurselection]"
}
#
# Non-editable Dropdown Combobox
#
iwidgets::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
#
iwidgets::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