ttk::labelframe manual page - Tk Themed Widget

## Tcl/Tk Documentation > Tk Commands, version 8.6.18 > ttk_labelframe

### 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::labelframe — Container widget with optional label
  SYNOPSIS
  DESCRIPTION
  STANDARD OPTIONS
    -class, undefined, undefined
    -cursor, cursor, Cursor
    -padding, padding, Padding
    -style, style, Style
    -takefocus, takeFocus, TakeFocus
  WIDGET-SPECIFIC OPTIONS
    -height, height, Height
    -labelanchor, labelAnchor, LabelAnchor
    -labelwidget, labelWidget, LabelWidget
    -text, text, Text
    -underline, underline, Underline
    -width, width, Width
  WIDGET COMMAND
  STYLING OPTIONS
  SEE ALSO
  KEYWORDS

### NAME

ttk::labelframe — Container widget with optional label

### SYNOPSIS

ttk::labelframe pathName ?options?

### DESCRIPTION

A ttk::labelframe widget is a container used to group other widgets together. It has an optional label, which may be a plain text string or another widget.

### STANDARD OPTIONS

-class, undefined, undefined
-cursor, cursor, Cursor
-padding, padding, Padding
-style, style, Style
-takefocus, takeFocus, TakeFocus

### WIDGET-SPECIFIC OPTIONS

Command-Line Name: -height
Database Name: height
Database Class: Height
  If specified, the widget's requested height in pixels. (See ttk::frame(n) for further notes on -width and -height).

Command-Line Name: -labelanchor
Database Name: labelAnchor
Database Class: LabelAnchor
  Specifies where to place the label. Allowed values are (clockwise from the top upper left corner): nw, n, ne, en, e, es, se, s,sw, ws, w and wn. The default value is theme-dependent.

Command-Line Name: -labelwidget
Database Name: labelWidget
Database Class: LabelWidget
  The name of a widget to use for the label. If set, overrides the -text option. The -labelwidget must be a child of the labelframe widget or one of the labelframe's ancestors, and must belong to the same top-level widget as the labelframe.

Command-Line Name: -text
Database Name: text
Database Class: Text
  Specifies the text of the label.

Command-Line Name: -underline
Database Name: underline
Database Class: Underline
  If set, specifies the integer index (0-based) of a character to underline in the text string. The underlined character is used for mnemonic activation. Mnemonic activation for a ttk::labelframe sets the keyboard focus to the first child of the ttk::labelframe widget.

Command-Line Name: -width
Database Name: width
Database Class: Width
  If specified, the widget's requested width in pixels.

### 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::labelframe is TLabelframe. The text label has a class of TLabelframe.Label.

Dynamic states: disabled, readonly.

TLabelframe styling options configurable with ttk::style are:

-background color
-bordercolor color
-borderwidth amount
-darkcolor color
-labelmargins amount
-labeloutside boolean
-lightcolor color
-relief relief

TLabelframe.Label styling options configurable with ttk::style are:

-background color
-font font
-foreground color

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, ttk::frame, labelframe

### KEYWORDS

widget, frame, container, label, groupbox
Copyright © 2005 Joe English