ttk_label man page

ttk::label — Display a text string and/or image


ttk::label pathName ?options?


A ttk::label widget displays a textual label and/or image. The label may be linked to a Tcl variable to automatically change the displayed text.

Standard Options

-class -compound -cursor
-image -style -takefocus
-text -textvariable -underline

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

Widget-Specific Options

Command-Line Name: -anchor
Database Name: anchor
Database Class: Anchor

Specifies how the information in the widget is positioned relative to the inner margins.  Legal values are n, ne, e, se, s, sw, w, nw, and center. See also -justify.

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

The widget's background color. If unspecified, the theme default is used.

Command-Line Name: -font
Database Name: font
Database Class: Font

Font to use for label text.

Command-Line Name: -foreground
Database Name: textColor
Database Class: TextColor

The widget's foreground color. If unspecified, the theme default is used.

Command-Line Name: -justify
Database Name: justify
Database Class: Justify

If there are multiple lines of text, specifies how the lines are laid out relative to one another. One of left, center, or right. See also -anchor.

Command-Line Name: -padding
Database Name: padding
Database Class: Padding

Specifies the amount of extra space to allocate for the widget. The padding is a list of up to four length specifications left top right bottom. If fewer than four elements are specified, bottom defaults to top, right defaults to left, and top defaults to left.

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

Specifies the 3-D effect desired for the widget border. Valid values are flat, groove, raised, ridge, solid, and sunken.

Command-Line Name: -text
Database Name: text
Database Class: Text

Specifies a text string to be displayed inside the widget (unless overridden by -textvariable).

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

Specifies the maximum line length (in pixels). If this option is less than or equal to zero, then automatic wrapping is not performed; otherwise the text is split into lines such that no line is longer than the specified value.

Widget Command

Supports the standard widget commands configure, cget, identify, instate, and state; see ttk::widget(n).

See Also

ttk::widget(n), label(n)


8.5 Tk Themed Widget