combobox(3tcl)

NAME

ttk::combobox - text field with popdown selection list

SYNOPSIS

ttk::combobox pathName ?options? -class -cursor -takefocus -style

OPTIONS

[-exportselection exportSelection ExportSelection] Boolean value. If set, the widget selection is linked to the X selection. [-justify justify Justify] Specifies how the text is aligned within the widget. One of left, center, or right. [-height height Height] Specifies the height of the pop-down listbox, in rows. [-postcommand postCommand PostCommand] A Tcl script to evaluate immediately before displaying the listbox. The -postcommand script may specify the -values to display. [-state state 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. [-textvariable textVariable 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. [-values values Values] Specifies the list of values to display in the drop-down listbox. [-width width Width] Specifies an integer value indicating the desired width of the entry window, in average-size characters of the widget's font.

DESCRIPTION

A 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.

WIDGET COMMAND

pathName cget option: Returns the current value of the specified option. See widget(n).

pathName configure ?option? ?value option value ...?: Modify or query widget options. See 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, or the empty string if the coordinates are outside the window.

pathName instate statespec ?script?: Test the widget state. See widget(n).

pathName set value: Sets the value of the combobox to value.

pathName state ?stateSpec?: Modify or query the widget state. See widget(n).

The combobox widget also supports the following entry widget commands (see entry(n) for details): bbox delete icursor index insert selection xview

VIRTUAL EVENTS