logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

ttk::spinbox - Selecting text field widget

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.

Indices

       See the ttk::entry manual for information about indexing characters.

Keywords

       entry, spinbox, widget, text field

Tk                                                     8.5                                     ttk::spinbox(3tk)

Name

       ttk::spinbox - Selecting text field widget

See Also

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

Standard Options

-validate-validatecommand

       See the ttk_entry manual entry for details on the standard options.

Styling Options

       The class name for a ttk::spinbox is TSpinbox.

       Dynamic states: active, disabled, focus, readonly.

       TSpinbox styling options configurable with ttk::style are:

       -arrowcolorcolor-arrowsizeamount-backgroundcolor
              For  backwards  compatibility,  when  using  the aqua theme (for macOS), this option behaves as an
              alias for the -fieldbackground provided that no value is specified for -fieldbackground. Otherwise
              it is ignored.
       -bordercolorcolor-darkcolorcolor-fieldbackgroundcolor-foregroundcolor-insertcolorcolor-insertwidthamount-lightcolorcolor-paddingpadding-placeholderforegroundcolor-selectbackgroundcolor-selectforegroundcolor

       Some options are only available for specific themes.

       See the ttk::style manual page for information on how to configure ttk styles.

Synopsis

ttk::spinboxpathName ?options?
________________________________________________________________________________________________________________

Validation

       See the ttk::entry manual for information about using the -validate and -validatecommand options.

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

Widget Command

       The  following subcommands are possible for spinbox widgets in addition to the commands described for the
       ttk::entry widget:

       pathNameget
              Returns the spinbox's current value.

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

Widget-Specific Options

       Command-Line Name:-command
       Database Name:  command
       Database Class: Command

              Specifies a Tcl command to be invoked whenever a spinbutton is invoked.

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

See Also