NAME¶
ttk::spinbox - Selecting text field widget
SYNOPSIS¶
ttk::spinbox pathName ?
options?
DESCRIPTION¶
A
ttk::spinbox widget is a
ttk::entry widget with built-in up and
down buttons that are used to either modify a numeric value or to select among
a set of values. The widget implements all the features of the
ttk::entry widget including support of the
-textvariable option
to link the value displayed by the widget to a Tcl variable.
STANDARD OPTIONS¶
-class -cursor -style
-takefocus -xscrollcommand
See the
ttk_widget manual entry for details on the standard options.
STANDARD OPTIONS¶
-validate -validatecommand
See the
ttk_entry manual entry for details on the standard options.
Command-Line Name: -from
Database Name: from
Database Class: From
- A floating-point value specifying the lowest value for the spinbox. This
is used in conjunction with -to and -increment to set a
numerical range.
Command-Line Name: -to
Database Name: to
Database Class: To
- A floating-point value specifying the highest permissible value for the
widget. See also -from and -increment. range.
Command-Line Name: -increment
Database Name: increment
Database Class: Increment
- A floating-point value specifying the change in value to be applied each
time one of the widget spin buttons is pressed. The up button applies a
positive increment, the down button applies a negative increment.
Command-Line Name: -values
Database Name: values
Database Class: Values
- This must be a Tcl list of values. If this option is set then this will
override any range set using the -from, -to and
-increment options. The widget will instead use the values
specified beginning with the first value.
Command-Line Name: -wrap
Database Name: wrap
Database Class: Wrap
- Must be a proper boolean value. If on, the spinbox will wrap around the
values of data in the widget.
Command-Line Name: -format
Database Name: format
Database Class: Format
- Specifies an alternate format to use when setting the string value when
using the -from and -to range. This must be a format
specifier of the form %<pad>.<pad>f, as it will format
a floating-point number.
Command-Line Name: -command
Database Name: command
Database Class: Command
- Specifies a Tcl command to be invoked whenever a spinbutton is
invoked.
INDICES¶
See the
ttk::entry manual for information about indexing characters.
VALIDATION¶
See the
ttk::entry manual for information about using the
-validate and
-validatecommand options.
The following subcommands are possible for spinbox widgets in addition to the
commands described for the
ttk::entry widget:
- pathName current index
- pathName get
- Returns the spinbox's current value.
- pathName set value
- Set the spinbox string to value. If a -format option has
been configured then this format will be applied. If formatting fails or
is not set or the -values option has been used then the value is
set directly.
VIRTUAL EVENTS¶
The spinbox widget generates a
<<Increment>> virtual event
when the user presses <Up>, and a
<<Decrement>>
virtual event when the user presses <Down>.
SEE ALSO¶
ttk::widget(3tk), ttk::entry(3tk), spinbox(3tk)
KEYWORDS¶
entry, spinbox, widget, text field