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 (c) 2017 Schelte Bron