ttk_spinbox - Selecting text field widget
ttk::spinbox pathName ?options?
ttk::spinbox(1t) Tk Themed Widget ttk::spinbox(1t)
______________________________________________________________________________
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.
WIDGET-SPECIFIC OPTIONS
Command-Line Name:-from
Database Name: from
Database Class: From
A floating-point value specifying the lowest value for the spin-
box. 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 spec-
ified 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 float-
ing-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.
WIDGET COMMAND
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>.
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), spinbox(n)
KEYWORDS
entry, spinbox, widget, text field
NOTES
Source code for open source software components in Oracle Solaris can
be found at https://www.oracle.com/downloads/opensource/solaris-source-
code-downloads.html.
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::spinbox(1t)