[ Table Of Contents ]

# matchbox(3tcl) 1.0 doc "Tk Themed Widget"

## Name

matchbox - text field with popdown selection and completion lists

## Synopsis

- package require Tk 8.6.3
- package require matchbox 1.0

## Description

The ttk::matchbox widget is an extension of the regular ttk::combobox widget. It can be used wherever a ttk::combobox is currently used, without any other changes to the code.

The difference between the ttk::matchbox widget and the ttk::combobox widget is in the interaction with the user. An empty ttk::matchbox looks just like a ttk::combobox. However, when there is any text in the ttk::matchbox, an icon appears on the right-hand side of the text field. The user can click this icon to erase the text.

## Widget-specific options

If the -matchcommand option is specified, an additional drop-down list may be displayed showing possible completions for the entered string.

Whenever the user changes the value of the ttk::matchbox widget, the command specified via the -matchcommand option is invoked with one additional argument; the current value of the widget. The command is expected to return a list of possible completions. These will be presented to the user via the second drop-down list of the widget. If the command returns an empty list, the drop-down list will not be displayed.

Note: The match command is not invoked when the user selects an entry from the main drop-down list.

## Default bindings

The ttk::matchbox has one additional key binding, Control-u, that also erases all text in the ttk::matchbox.

## Copyright

Copyright © 2017 Schelte Bron