Ubuntu Manpages

ttk::spinbox

Selecting text field widget






ttk::spinbox pathName ?options?








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.






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.








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






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






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



  

  

  

  
Returns the spinbox's current 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.








The spinbox widget generates a <<Increment>>
    virtual event when the user presses <Up>, and a
    <<Decrement>> virtual event when the user presses
    <Down>.






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






entry, spinbox, widget, text field