---
name: "label"
section: "3tcl"
platform: "linux"
package: "tk-tile"
version: "0.8.2-2.1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/label"
---

# label(3tcl)

Display a text string and/or image

## NAME

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

## SYNOPSIS

**ttk::label** *pathName* ?*options*?

## DESCRIPTION

A **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	-width

## 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 .TH  3tcl-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

- *pathName* **cget** *option*

  - *pathName* **configure** ?*option*? ?*value option value ...*?

  - *pathName* **instate** *statespec* ?*script*?

  - *pathName* **state** ?*stateSpec*?

  See *widget(n)*

## SEE ALSO

widget(n)