ttk::labelframe(n)

💖 NAME 💖

okay bestie, welcome to ttk::labelframe(n) — the Tk Themed Widget page for a container widget with an optional label. It’s giving groupbox energy, and honestly it’s here to group your other widgets together. 🫶✨

---

🌸 SYNOPSIS 🌸

ttk::labelframe pathName ?options?

---

🦋 DESCRIPTION 🦋

A ttk::labelframe widget is a container used to group other widgets together. It has an optional label, which may be a plain text string or another widget. Simple as that, no cap. 💅

---

✨ STANDARD OPTIONS ✨

Here are the standard options, bestie — each one is a whole vibe:

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

See the ttk_widget manual entry for details on the standard options. 👑

---

🎀 WIDGET-SPECIFIC OPTIONS 🎀

• -height — Database name: height; database class: Height. If specified, the widget’s requested height in pixels. (See ttk::frame(n) for further notes on -width and -height.)
• -labelanchor — Database name: labelAnchor; database class: LabelAnchor. Specifies where to place the label. Allowed values are (clockwise from the top upper left corner): nw, n, ne, en, e, es, se, s, sw, ws, w and wn. The default value is theme-dependent.
• -labelwidget — Database name: labelWidget; database class: LabelWidget. The name of a widget to use for the label. If set, overrides the -text option. The -labelwidget must be a child of the labelframe widget or one of the labelframe’s ancestors, and must belong to the same top-level widget as the labelframe.
• -text — Database name: text; database class: Text. Specifies the text of the label. 🎀
• -underline — Database name: underline; database class: Underline. If set, specifies the integer index (0-based) of a character to underline in the text string. The underlined character is used for mnemonic activation. Mnemonic activation for a ttk::labelframe sets the keyboard focus to the first child of the ttk::labelframe widget.
• -width — Database name: width; database class: Width. If specified, the widget’s requested width in pixels.

---

💀 WIDGET COMMAND 💀

Labelframe widgets support the standard commands cget, configure, identify element, instate, state and style (see ttk::widget). Periodt — those are the commands, and they’re all coming from the standard widget behavior. 🫶

---

🌈 STYLING OPTIONS 🌈

The class name for a ttk::labelframe is TLabelframe. The text label has a class of TLabelframe.Label. Highkey important if you’re doing style stuff. 👑

Dynamic states: disabled, readonly.

TLabelframe styling options configurable with ttk::style are:

• -background — color
• -bordercolor — color
• -borderwidth — amount
• -darkcolor — color
• -labelmargins — amount
• -labeloutside — boolean
• -lightcolor — color
• -relief — relief

TLabelframe.Label styling options configurable with ttk::style are:

• -background — color
• -font — font
• -foreground — color

Some options are only available for specific themes. Not every style option is gonna show up for every theme — that’s just how it is, bestie. 🦋

See the ttk::style manual page for information on how to configure ttk styles.

---

👀 SEE ALSO 👀

• ttk::widget(n)
• ttk::frame(n)
• labelframe(n)

---

🔥 KEYWORDS 🔥

widget, frame, container, label, groupbox

---

okay that’s the whole page, bestie — it’s from Tk 8.5, and the manual page is ttk::labelframe(n). slay, go group those widgets 💖✨🎀