W3cubDocs

/Tcl/Tk

ttk_spinbox

NAME
ttk::spinbox — Selecting text field widget
SYNOPSIS
DESCRIPTION
STANDARD OPTIONS
-class, undefined, undefined
-cursor, cursor, Cursor
-style, style, Style
-takefocus, takeFocus, TakeFocus
-validate, validate, Validate
-validatecommand, validateCommand, ValidateCommand
-xscrollcommand, xScrollCommand, ScrollCommand
WIDGET-SPECIFIC OPTIONS
-from, from, From
-to, to, To
-increment, increment, Increment
-values, values, Values
-wrap, wrap, Wrap
-format, format, Format
-command, command, Command
INDICES
VALIDATION
WIDGET COMMAND
pathName current index
pathName get
pathName set value
VIRTUAL EVENTS
SEE ALSO
KEYWORDS

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, undefined, undefined
-cursor, cursor, Cursor
-style, style, Style
-takefocus, takeFocus, TakeFocus
-validate, validate, Validate
-validatecommand, validateCommand, ValidateCommand
-xscrollcommand, xScrollCommand, ScrollCommand

Widget-specific 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.

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>.

See also

ttk::widget, ttk::entry, spinbox

Copyright © 2008 Pat Thoyts