ttk::label(n) Tk Themed Widget ttk::label(n)

```

```

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

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

```

```

# [DESCRIPTION](#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](#STANDARD_OPTIONS)

```
-anchor	-class	-compound
-cursor	-font	-foreground
-image	-justify	-padding
-state	-style	-takefocus
-text	-textvariable	-underline
-width	-wraplength
```

See the **ttk\_widget** manual entry for details on the standard options.

# [WIDGET-SPECIFIC OPTIONS](#WIDGET-SPECIFIC_OPTIONS)

```
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:	-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 negative or 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](#WIDGET_COMMAND)

Label widgets support the standard commands **cget**, **configure**, **identify element**, **instate**, **state** and **style** (see **ttk::widget**).

# [STYLING OPTIONS](#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](#SEE_ALSO)

[ttk::widget(n)](/man/os/tk/ttk::widget.n), [label(n)](/man/os/tk/label.n)

8.5 Tk

---

Document: ttk_label(n) from tk 9.0.4-r2 (Chainguard OS)
Source: https://downloads.sourceforge.net/sourceforge/tcl/tk9.0.4-src.tar.gz