ttk::label

Section: Tk Themed Widget (n)
Updated: 8.5
Index Return to Main Contents

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

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

WIDGET-SPECIFIC OPTIONS

[ -anchor anchor 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. [ -background frameColor FrameColor ] The widget's background color. If unspecified, the theme default is used. [ -font font Font ] Font to use for label text. [ -foreground textColor TextColor ] The widget's foreground color. If unspecified, the theme default is used. [ -justify justify 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. [ -padding padding 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. [ -relief relief Relief ] Specifies the 3-D effect desired for the widget border. Valid values are flat, groove, raised, ridge, solid, and sunken. [ -text text Text ] Specifies a text string to be displayed inside the widget (unless overridden by -textvariable). [ -wraplength wrapLength 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).