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

SEE ALSO

       ttk::widget(3tk), ttk::entry(3tk), spinbox(3tk)

KEYWORDS

       entry, spinbox, widget, text field