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



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.  


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

See the ttk_widget manual entry for details on the standard 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.  


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


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