ttk::scale(3tk)

✨ ttk::scale ✨

okay bestie, welcome to ttk::scale, from the Tk Themed Widget family of manual pages 💅 this is the page that tells you how to create and manipulate a scale widget, and honestly? she's iconic.

---

🌸 SYNOPSIS 🌸

ttk::scale pathName ?options...?

---

🎀 DESCRIPTION 🎀

so a ttk::scale widget is the girl you call when you need to control the numeric value of a linked variable that varies uniformly over some range 🫶

she displays a slider that you can move along over a trough, and the relative position of that slider over the trough is literally telling you the value of the variable. it's giving "visual representation of a number", no cap ✨

---

💖 STANDARD OPTIONS 💖

these are the basics every themed widget gets:

• -class
• -cursor
• -style
• -takefocus

if you want the tea on all of these, go read the ttk_widget manual entry. she has the details, fr fr 💜

---

🌈 WIDGET-SPECIFIC OPTIONS 🌈

these are the ones that make scale scale, iykyk 🦋

• -command — Command-Line Name: -command, Database Name: command, Database Class: Command Specifies the prefix of a Tcl command to invoke whenever the scale's value gets changed via a widget command. the actual command is this option, then a space, then a real number that's the new value of the scale 👑
• -from — Command-Line Name: -from, Database Name: from, Database Class: From a real value that corresponds to the left or top end of the scale 💫
• -length — Command-Line Name: -length, Database Name: length, Database Class: Length specifies the desired long dimension of the scale in screen units (i.e. any of the forms acceptable to Tk_GetPixels). for vertical scales this is the scale's height; for horizontal scales it's the scale's width 📏
• -orient — Command-Line Name: -orient, Database Name: orient, Database Class: Orient specifies which orientation the widget should be laid out in — horizontal or vertical. must be either horizontal or vertical, or an abbreviation of one of these 🌈
• -to — Command-Line Name: -to, Database Name: to, Database Class: To specifies a real value corresponding to the right or bottom end of the scale. this value may be either less than or greater than the -from option 👀
• -value — Command-Line Name: -value, Database Name: value, Database Class: Value specifies the current floating-point value of the variable. if -variable is set to an existing variable, specifying -value has no effect — the variable value takes precedence 💀
• -variable — Command-Line Name: -variable, Database Name: variable, Database Class: Variable specifies the name of a global variable to link to the scale. whenever the value of the variable changes, the scale updates to reflect this value. and whenever the scale is manipulated interactively, the variable gets modified to reflect the scale's new value. it's a whole two-way situationship 🫶

---

💅 WIDGET COMMAND 💅

besides the standard cget, configure, identify element, instate, state and style commands (peep the ttk::widget manual for those), scale widgets support these extra commands:

• pathName get ?x y? — gets the current value of the -value option, or the value corresponding to the coordinates x,y if they're specified. x and y are pixel coordinates relative to the scale widget origin 📍
• pathName set value — sets the value of the widget (i.e. the -value option) to value. the value gets clipped to the range given by the -from and -to options. note that setting the linked variable (i.e. the variable named in the -variable option) does not cause such clipping ⚠️

---

🔥 INTERNAL COMMANDS 🔥

• pathName coords ?value? — gets the coordinates corresponding to value, or the coordinates corresponding to the current value of the -value option if value is omitted 🧚

---

👑 STYLING OPTIONS 👑

the class name for a ttk::scale is TScale 💖

dynamic states: active.

TScale styling options configurable with ttk::style are:

• -background color
• -borderwidth amount
• -darkcolor color
• -groovewidth amount
• -lightcolor color
• -sliderwidth amount
• -troughcolor color
• -troughrelief relief

some of these options are only available for specific themes 👀

see the ttk::style manual page for info on how to configure ttk styles ✨

---

🦋 SEE ALSO 🦋

• ttk::widget(3tk)
• scale(3tk)

---

⭐ KEYWORDS ⭐

scale, slider, trough, widget

---

and that's the whole page bestie, you ate 🍓 this one's from Tk 8.5, and yes the manual page is literally called ttk::scale(3tk) — go forth and slay your sliders 💅✨🌈