NAME

       ttk::combobox - text field with popdown selection list

SYNOPSIS

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

OPTIONS

       [-exportselection exportSelection]  Boolean value.  If set, the widget selection is linked
       to the X selection.  [-justify justify] Specifies how  the  text  is  aligned  within  the
       widget.  One of left, center, or right.  [-height height] Specifies the height of the pop-
       down listbox, in rows.  [-postcommand postCommand] A Tcl script  to  evaluate  immediately
       before  displaying  the  listbox.   The  -postcommand  script  may  specify the -values to
       display.  [-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] 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] Specifies the list of
       values to display in the drop-down listbox.  [-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

       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)