ttk::label manual page - Tk Themed Widget

## Tcl8.6.16/Tk8.6.16 Documentation > Tk Commands, version 8.6.16 > ttk_label

### Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

  NAME
    ttk::label — Display a text string and/or image
  SYNOPSIS
  DESCRIPTION
  STANDARD OPTIONS
    -class, undefined, undefined
    -compound, compound, Compound
    -cursor, cursor, Cursor
    -image, image, Image
    -padding, padding, Padding
    -state, state, State
    -style, style, Style
    -takefocus, takeFocus, TakeFocus
    -text, text, Text
    -textvariable, textVariable, Variable
    -underline, underline, Underline
    -width, width, Width
  WIDGET-SPECIFIC OPTIONS
    -anchor, anchor, Anchor
    -background, frameColor, FrameColor
    -font, font, Font
    -foreground, textColor, TextColor
    -justify, justify, Justify
    -relief, relief, Relief
    -wraplength, wrapLength, WrapLength
  WIDGET COMMAND
  STYLING OPTIONS
  SEE ALSO

### 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, undefined, undefined
-compound, compound, Compound
-cursor, cursor, Cursor
-image, image, Image
-padding, padding, Padding
-state, state, State
-style, style, Style
-takefocus, takeFocus, TakeFocus
-text, text, Text
-textvariable, textVariable, Variable
-underline, underline, Underline
-width, width, Width

### WIDGET-SPECIFIC OPTIONS

Command-Line Name: -anchor
Database Name: anchor
Database Class: 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.

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: -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 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).

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

ttk::widget, label
Copyright © 2004 Joe English