---
name: "combobox"
section: "3tcl"
platform: "linux"
package: "tk-tile"
version: "0.8.2-2.1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/combobox/3tcl"
---

# combobox(3tcl)

text field with popdown selection list

## 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)](/entry/n.md)* for details): bbox	delete	icursor index	insert	selection xview

## VIRTUAL EVENTS

The combobox widget generates a **\<\<ComboboxSelected\>\>** virtual event when the user selects an element from the list of values. This event is generated after the listbox is unposted.

## SEE ALSO

widget(n), [entry(n)](/entry/n.md)