2. EL 6 ELS
  3. tk
  4. ttk_combobox(n)

Scroll to navigation

ttk::combobox(n) Tk Themed Widget ttk::combobox(n) 





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 ttk_widget manual entry for details on the standard
    options.






WIDGET-SPECIFIC 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.






WIDGET COMMAND



  

  
Returns the current value of the specified option. See
      ttk::widget(n).

  

  
Modify or query widget options. See ttk::widget(n).

  

  
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.

  

  
Returns the current value of the combobox.

  

  
Returns the name of the element at position x, y. See
      ttk::widget(n).

  

  
Test the widget state. See ttk::widget(n).

  

  
Sets the value of the combobox to value.

  

  
Modify or query the widget state. See ttk::widget(n).




The combobox widget also supports the following ttk::entry
    widget commands (see ttk::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. If the selection action unposts the
    listbox, this event is delivered after the listbox is unposted.






SEE ALSO


ttk::widget(n), ttk::entry(n)






KEYWORDS


choice, entry, list box, text box, widget







  

    8.5
    Tk