A textentry widget displays a one-line text string and allows that string to be edited by the user.

tic_textentry(
  textvariable,
  validate,
  validatecommand,
  width,
  bind = NULL,
  pack = NULL,
  ...
)

Arguments

textvariable

Reactive value for the value displayed in this widget

validate

when to vdlidate the contents of this text box. Possible values: none, key, focus, focusin, focusout, all. If this is not set then the validatecommand function will never be run.

validatecommand

function to call when validation event occurs. This function must return a non-NA boolean value.

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

Details

The value of the string is linked to a reacive variaable with the textvariable argument.

Note: in tcl/tk this object is known as entry widget, rather than textentry.

tcl/tk

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