ttk::label(3tk)

💖 ttk::label — the manual, but make it cute 💖

okay bestie, sit down, hydrate, and let me tell you about ttk::label, a themed widget from the Tk toolkit (this is the ttk::label(3tk) page, mwah 💅).

---

✨ NAME ✨

ttk::label — display a text string and/or image. that's it. that's the whole job. and she does it flawlessly. 👑

---

🌸 SYNOPSIS 🌸

ttk::label pathName ?options?

---

🦋 DESCRIPTION 🦋

A ttk::label widget shows a textual label and/or an image. literally a glow-up for your text, no cap. 💖

and here's the iconic part: the label can be linked to a Tcl variable so the displayed text changes automatically. main character behavior. she updates herself. periodt. ✨

---

🎀 STANDARD OPTIONS 🎀

these are the standard girlies, the whole squad:

• -anchor
• -class
• -compound
• -cursor
• -font
• -foreground
• -image
• -justify
• -padding
• -state
• -style
• -takefocus
• -text
• -textvariable
• -underline
• -width
• -wraplength

psst — for the full deets on any of these, go read the ttk_widget manual entry. she's got the lore. 📖

---

💅 WIDGET-SPECIFIC OPTIONS 💅

these ones are hers. custom. exclusive. iykyk. 🫶

-background

• Command-Line Name: -background
• Database Name: frameColor
• Database Class: FrameColor

the widget's background color. if you don't specify it, the theme default gets used. let the theme cook. 🍓

-relief

• Command-Line Name: -relief
• Database Name: relief
• Database Class: Relief

specifies the 3-D effect you want for the widget border. the valid values are: flat, groove, raised, ridge, solid, and sunken. pick your vibe, bestie. ✨

-wraplength

• Command-Line Name: -wraplength
• Database Name: wrapLength
• Database Class: WrapLength

specifies the maximum line length, in pixels. if this option is negative or zero, then automatic wrapping is not performed — no wrapping, she just goes off the edge, iconic but chaotic 😭. otherwise the text gets split into lines such that no line is longer than the value you specified. 🧚

---

👑 WIDGET COMMAND 👑

label widgets support the standard commands cget, configure, identify element, instate, state and style. (check ttk::widget for those — she's the source of truth. 💜)

---

🌈 STYLING OPTIONS 🌈

the class name for a ttk::label is TLabel.

Dynamic states: disabled, readonly.

TLabel styling options you can configure with ttk::style are:

• -background color
• -compound compound
• -foreground color
• -font font

heads up bestie: some options are only available for specific themes. not every theme comes with the full closet. 👗

for the full tea on how to configure ttk styles, see the ttk::style manual page.

---

🔥 SEE ALSO 🔥

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

---

💖 cute sign-off 💖

that's the whole page, bestie — this manual is from Tk 8.5, and it's filed under ttk::label(3tk). go forth and label things beautifully. slay, ate, no crumbs. 🌟💅🦋