| ActiveTcl User Guide |

Table of Contents

______________________________________________________________________________

## 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.

## Standard Options

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

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

## Options

Command-Line Name:-anchor
Database Name: anchor
Database Class: Anchor

Specifies how the information in the widget is positioned rela-tive 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:-padding
Database Name: padding
Database Class: 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.

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:-text
Database Name: text
Database Class: Text

Specifies a text string to be displayed inside the widget (unless overridden by -textvariable).

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

pathName cget option

pathName configure ?option? ?value option value ...?

pathName instate statespec ?script?

pathName state ?stateSpec?
See widget(n)

## See Also

widget(n)

tile 0.2 label(n)

Table of Contents

- Name
- Synopsis
- Description
- Standard Options
- Options
- Widget Command
- See Also