Scroll to navigation

ttk::spinbox(3tk) Tk Themed Widget ttk::spinbox(3tk) 


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.




SEE ALSO

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

KEYWORDS

entry, spinbox, widget, text field



  

    8.5.9
    Tk