Combobox: text field with popdown selection list

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.

tic_combobox(
  values,
  textvariable,
  justify,
  state,
  width,
  bind = NULL,
  pack = NULL,
  ...
)

Arguments

values

Specifies the list of values to display in the drop-down listbox.

textvariable

Reactive value for the current selected value in this widget

justify

one of left, center, right

state

one of normal, readonly, disabled. Default: normal

width

If greater than zero, specifies how much space, in character widths, to allocate for the text label. If less than zero, specifies a minimum width. If zero or unspecified, the natural width of the text label is used.

bind

bind commands to particular events on this element. This may be a single result of bind_opts() or a list of them for multiple events.

pack

a named list of pack options for how to incorporate this element into its parent container. Default: NULL means to use the standard packing. See pack_opts() as a way of creating a valid list of pack options.

...

Other arguments are parsed as follows:

named arguments

Further options to be used during the creation of this widget. See the tcl/tk documentation for all arguments possible for this widget.

unnamed arguments

Container widgets (e.g. tic_frame()) treat any unnamed arguments as child objects. Non-container widgets (e.g tic_button()) will raise an error if there are any unnamed widgets.

Value

handle on the tcl/tk object

tcl/tk

See tcl/tk documentation for more information on this element https://www.tcl.tk/man/tcl8.6/TkCmd/ttk_combobox.htm

See also

Other widgets: tic_button(), tic_canvas(), tic_checkbutton(), tic_label(), tic_menubutton(), tic_menuitem(), tic_menu(), tic_progressbar(), tic_radiobutton(), tic_separator(), tic_sizegrip(), tic_slider(), tic_spinbox(), tic_submenu(), tic_textbox(), tic_textentry()

Examples

opts <- c('alpha', 'bravo', 'charlie')
selected <- reactive_chr(opts[1])
tic_window(
  title = "Demo",
  tic_combobox(values = opts, textvariable = selected)
)
#> List of 9
#>  $ args     : Named list()
#>  $ type     : chr "window"
#>  $ children :List of 1
#>   ..$ :List of 5
#>   .. ..$ args    :List of 2
#>   .. .. ..$ values      : chr [1:3] "alpha" "bravo" "charlie"
#>   .. .. ..$ textvariable:List of 1
#>   .. .. .. ..$ env:<environment: 0x7f996ebcc9e0> 
#>   .. .. .. ..- attr(*, "class")= chr "tclVar"
#>   .. ..$ type    : chr "combobox"
#>   .. ..$ children: list()
#>   .. ..$ binding : NULL
#>   .. ..$ pack    : NULL
#>  $ binding  : NULL
#>  $ title    : chr "Demo"
#>  $ width    : NULL
#>  $ height   : NULL
#>  $ idle_func: NULL
#>  $ idle_fps : num 30