ttk_spinbox (n) - Linux Manuals

ttk_spinbox: Selecting text field widget

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

KEYWORDS

entry, spinbox, widget, text field