ActiveTcl User Guide
| |
ActiveTcl User Guide
|
|
gets iwidgets::combobox pathName ?options? itk::Widget <- iwid- gets::LabeledWidget <- iwidgets::Entryfield <- iwidgets::Combobox
background borderWidth cursor justify exportSelection foreground highlightColor highlightThickness
tions.
hscrollmode textBackground textFont
vscrollmode
inherited options.
show
option.
childSitePos command fixed
focusCommand
ited options.
labelBitmap labelFont labelImage
labelMargin
herited 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 ar- row 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.
ue 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 en- try 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. The iwidgets::combobox command creates a new Tcl command whose name is pathName. This command may be used to invoke various opera- tions on the widget. It has the following general form:
pathName option ?arg arg ...?
ed methods.
curselection index see size
ated methods.
associated methods. pathName cget option Returns the current value of the configuration option given by option. Option may have any of the values accepted by the iwidgets::combobox com- mand. pathName clear ?component? Clears the contents from one or both components. Valid component values are list, or entry.
ure ?option? ?value option value ...? Query or modify the con- figuration options of the widget. If no option is specified, re- turns a list describing all of the available 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? Delete one or more elements from a given component, list or entry. If a list item to be removed is currently selected (displayed in the entry field area), the entry field will be cleared. pathName get ?index? With no arguments, returns the contents currently in the entry field area. With a single argu- ment, returns the contents of the listbox item at the indicated index. pathName insert component index element ?element element ...? Insert one or more new elements into the given component, list or entry, just before the element given by index. pathName selection option first ?last? Adjust the selection within the listbox component and updates the 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.
lect from. For dropdown Comboboxes, this component is hidden un- til 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. The
items - the Scrolledlistbox and Entryfield. However it also adds these: [1] Button-1 mouse press on the arrow key of a dropdown
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 dropdown 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 se- lect the current item. They also remove the popped up list for dropdown comboboxes. [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
and arrow button component Shift-Up and Shift-Down arrow keys pop up and down the listbox of a dropdown Combobox. 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
field, scrolledlistbox, itk::Widget, entry, listbox, widget, iwidgets