1ttk::spinbox(n)                Tk Themed Widget                ttk::spinbox(n)
2
3
4
5______________________________________________________________________________
6

NAME

8       ttk::spinbox - Selecting text field widget
9

SYNOPSIS

11       ttk::spinbox pathName ?options?
12______________________________________________________________________________
13

DESCRIPTION

15       A  ttk::spinbox widget is a ttk::entry widget with built-in up and down
16       buttons that are used to either modify a numeric  value  or  to  select
17       among  a  set  of values. The widget implements all the features of the
18       ttk::entry widget including support of the -textvariable option to link
19       the value displayed by the widget to a Tcl variable.
20

STANDARD OPTIONS

22       -class                -cursor              -style
23       -takefocus            -xscrollcommand
24
25       See the ttk_widget manual entry for details on the standard options.
26

STANDARD OPTIONS

28       -validate             -validatecommand
29
30       See the ttk_entry manual entry for details on the standard options.
31

WIDGET-SPECIFIC OPTIONS

33       Command-Line Name:-from
34       Database Name:  from
35       Database Class: From
36
37              A floating-point value specifying the lowest value for the spin‐
38              box. This is used in conjunction with -to and -increment to  set
39              a numerical range.
40
41       Command-Line Name:-to
42       Database Name:  to
43       Database Class: To
44
45              A  floating-point value specifying the highest permissible value
46              for the widget. See also -from and -increment.  range.
47
48       Command-Line Name:-increment
49       Database Name:  increment
50       Database Class: Increment
51
52              A floating-point value specifying the  change  in  value  to  be
53              applied each time one of the widget spin buttons is pressed. The
54              up button applies a positive increment, the down button  applies
55              a negative increment.
56
57       Command-Line Name:-values
58       Database Name:  values
59       Database Class: Values
60
61              This  must  be  a Tcl list of values. If this option is set then
62              this will override any  range  set  using  the  -from,  -to  and
63              -increment options. The widget will instead use the values spec‐
64              ified beginning with the first value.
65
66       Command-Line Name:-wrap
67       Database Name:  wrap
68       Database Class: Wrap
69
70              Must be a proper boolean value.  If on, the  spinbox  will  wrap
71              around the values of data in the widget.
72
73       Command-Line Name:-format
74       Database Name:  format
75       Database Class: Format
76
77              Specifies  an  alternate  format  to use when setting the string
78              value when using the -from and -to range.  This must be a format
79              specifier  of the form %<pad>.<pad>f, as it will format a float‐
80              ing-point number.
81
82       Command-Line Name:-command
83       Database Name:  command
84       Database Class: Command
85
86              Specifies a Tcl command to be invoked whenever a  spinbutton  is
87              invoked.
88

INDICES

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

VALIDATION

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

WIDGET COMMAND

97       The following subcommands are possible for spinbox widgets in  addition
98       to the commands described for the ttk::entry widget:
99
100       pathName current index
101
102       pathName get
103              Returns the spinbox's current value.
104
105       pathName set value
106              Set  the  spinbox  string to value. If a -format option has been
107              configured then this format will be applied. If formatting fails
108              or is not set or the -values option has been used then the value
109              is set directly.
110

VIRTUAL EVENTS

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

SEE ALSO

117       ttk::widget(n), ttk::entry(n), spinbox(n)
118

KEYWORDS

120       entry, spinbox, widget, text field
121
122
123
124Tk                                    8.5                      ttk::spinbox(n)