Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, June 13, 2019
 
 

ttk_combobox (1t)

Name

ttk_combobox - text field with popdown selection list

Synopsis

ttk::combobox pathName ?options?

Description

ttk::combobox(1t)              Tk Themed Widget              ttk::combobox(1t)



______________________________________________________________________________

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
       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 list-
              box.  The -postcommand script may specify the  -values  to  dis-
              play.

       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  wid-
              get 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 list-
              box.

       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  sub-
       commands (see ttk::entry(n) for details):

              bbox                  delete               icursor
              index                 insert               selection
              xview

       The  combobox  widget  also  supports the following generic ttk::widget
       widget subcommands (see ttk::widget(n) 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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | runtime/tk-8     |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+
SEE ALSO
       ttk::widget(n), ttk::entry(n)

KEYWORDS
       choice, entry, list box, text box, widget



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source        was        downloaded        from         https://source-
       forge.net/projects/tcl/files/Tcl/8.6.7/tk8.6.7-src.tar.gz/download

       Further information about this software can be found on the open source
       community website at https://www.tcl.tk/.



Tk                                    8.5                    ttk::combobox(1t)