---
name: "ttk::combobox"
section: "3tk"
platform: "linux"
package: "tk8.5-doc"
version: "8.5.19-1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/ttk::combobox"
---

# ttk::combobox(3tk)

text field with popdown selection list

```

```

## NAME

ttk::combobox - text field with popdown selection list

## SYNOPSIS

**ttk::combobox** *pathName* ?*options*?

```

```

## DESCRIPTION

A **ttk::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.

## STANDARD OPTIONS

```
-class	-cursor	-takefocus
-style
```

See the  manual entry for details on the standard options.

## WIDGET-SPECIFIC OPTIONS

```
Command-Line Name:	-exportselection
Database Name:	exportSelection
Database Class:	ExportSelection
```

-

  Boolean value. If set, the widget selection is linked to the X selection.

```
Command-Line Name:	-justify
Database Name:	justify
Database Class:	Justify
```

-

  Specifies how the text is aligned within the widget. Must be one of **left**, **center**, or **right**.

```
Command-Line Name:	-height
Database Name:	height
Database Class:	Height
```

-

  Specifies the height of the pop-down listbox, in rows.

```
Command-Line Name:	-postcommand
Database Name:	postCommand
Database Class:	PostCommand
```

-

  A Tcl script to evaluate immediately before displaying the listbox. The **-postcommand** script may specify the **-values** to display.

```
Command-Line Name:	-state
Database Name:	state
Database Class:	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.

```
Command-Line Name:	-textvariable
Database Name:	textVariable
Database Class:	TextVariable
```

-

  Specifies the name of a global variable whose value is linked  to the widget value. Whenever the variable changes value the widget value is updated, and vice versa.

```
Command-Line Name:	-values
Database Name:	values
Database Class:	Values
```

-

  Specifies the list of values to display in the drop-down listbox.

```
Command-Line Name:	-width
Database Name:	width
Database Class:	Width
```

-

  Specifies an integer value indicating the desired width of the entry window, in average-size characters of the widget's font.

## WIDGET COMMAND

The following subcommands are possible for combobox widgets:

- *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* **set** *value*

  Sets the value of the combobox to *value*.

The combobox widget also supports the following **ttk::entry** widget subcommands (see *[ttk::entry(3tk)](/ttk::entry/3tk.md)* for details):

```

bbox	delete	icursor
index	insert	selection
xview
```

The combobox widget also supports the following generic **ttk::widget** widget subcommands (see *[ttk::widget(3tk)](/ttk::widget/3tk.md)* for details):

```

cget	configure	identify
instate	state
```

## VIRTUAL EVENTS

The combobox widget generates a **\<\<ComboboxSelected\>\>** virtual event when the user selects an element from the list of values. If the selection action unposts the listbox, this event is delivered after the listbox is unposted.

## SEE ALSO

[ttk::widget(3tk)](/ttk::widget/3tk.md), [ttk::entry(3tk)](/ttk::entry/3tk.md)

## KEYWORDS

choice, entry, list box, text box, widget