NAME¶

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

SYNOPSIS¶

ttk::label pathName ?options?

DESCRIPTION¶

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	-padding	-state
-style	-takefocus	-text
-textvariable	-underline	-width

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:	-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:	-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).

STYLING OPTIONS¶

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

Dynamic states: disabled, readonly.

TLabel styling options configurable with ttk::style are:

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

Some options are only available for specific themes.

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

SEE ALSO¶

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