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

NAME

8       ttk::scale - Create and manipulate a scale widget
9

SYNOPSIS

11       ttk::scale pathName ?options...?
12______________________________________________________________________________
13

DESCRIPTION

15       A ttk::scale widget is typically used to control the numeric value of a
16       linked variable that varies uniformly over some range. A scale displays
17       a slider that can be moved along over a trough, with the relative posi‐
18       tion of the slider over the trough indicating the value  of  the  vari‐
19       able.
20

STANDARD OPTIONS

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

WIDGET-SPECIFIC OPTIONS

28       Command-Line Name:-command
29       Database Name:  command
30       Database Class: Command
31
32              Specifies  the  prefix  of  a Tcl command to invoke whenever the
33              scale's value is changed via a widget command. The  actual  com‐
34              mand consists of this option followed by a space and a real num‐
35              ber indicating the new value of the scale.
36
37       Command-Line Name:-from
38       Database Name:  from
39       Database Class: From
40
41              A real value corresponding to the left or top end of the scale.
42
43       Command-Line Name:-length
44       Database Name:  length
45       Database Class: Length
46
47              Specifies the desired long dimension  of  the  scale  in  screen
48              units  (i.e.  any  of the forms acceptable to Tk_GetPixels). For
49              vertical scales this  is  the  scale's  height;  for  horizontal
50              scales it is the scale's width.
51
52       Command-Line Name:-orient
53       Database Name:  orient
54       Database Class: Orient
55
56              Specifies  which  orientation  whether the widget should be laid
57              out horizontally or vertically. Must  be  either  horizontal  or
58              vertical or an abbreviation of one of these.
59
60       Command-Line Name:-to
61       Database Name:  to
62       Database Class: To
63
64              Specifies  a real value corresponding to the right or bottom end
65              of the scale.  This value may be either  less  than  or  greater
66              than the -from option.
67
68       Command-Line Name:-value
69       Database Name:  value
70       Database Class: Value
71
72              Specifies  the current floating-point value of the variable.  If
73              -variable is set to an existing variable, specifying -value  has
74              no effect (the variable value takes precedence).
75
76       Command-Line Name:-variable
77       Database Name:  variable
78       Database Class: Variable
79
80              Specifies  the  name  of a global variable to link to the scale.
81              Whenever the value of the variable changes, the scale  will  up‐
82              date  to  reflect this value.  Whenever the scale is manipulated
83              interactively, the variable will  be  modified  to  reflect  the
84              scale's new value.
85

WIDGET COMMAND

87       pathName cget option
88              Returns the current value of the specified option; see ttk::wid‐
89              get(n).
90
91       pathName configure ?option? ?value option value ...?
92              Modify or query widget options; see ttk::widget(n).
93
94       pathName get ?x y?
95              Get the current value of the -value option, or the value  corre‐
96              sponding  to  the coordinates x,y if they are specified. X and y
97              are pixel coordinates relative to the scale widget origin.
98
99       pathName identify x y
100              Returns the name of the element at position x, y.  See ttk::wid‐
101              get(n).
102
103       pathName instate statespec ?script?
104              Test the widget state; see ttk::widget(n).
105
106       pathName set value
107              Set  the  value of the widget (i.e. the -value option) to value.
108              The value will be clipped to the range given by  the  -from  and
109              -to  options.  Note  that  setting the linked variable (i.e. the
110              variable named in the -variable  option)  does  not  cause  such
111              clipping.
112
113       pathName state ?stateSpec?
114              Modify or query the widget state; see ttk::widget(n).
115

INTERNAL COMMANDS

117       pathName coords ?value?
118              Get  the  coordinates corresponding to value, or the coordinates
119              corresponding to the current value of the -value option if value
120              is omitted.
121

STYLING OPTIONS

123       The class name for a ttk::scale is TScale.
124
125       Dynamic states: active.
126
127       TScale styling options configurable with ttk::style are:
128
129       -background color
130       -borderwidth amount
131       -darkcolor color
132       -groovewidth amount
133       -lightcolor color
134       -sliderwidth amount
135       -troughcolor color
136       -troughrelief relief
137
138       Some options are only available for specific themes.
139
140       See  the ttk::style manual page for information on how to configure ttk
141       styles.
142

SEE ALSO

144       ttk::widget(n), scale(n)
145

KEYWORDS

147       scale, slider, trough, widget
148
149
150
151Tk                                    8.5                        ttk::scale(n)