elements -
catalogue of themable elements
The following elements are used by the built-in widgets,
and are available for use in custom layouts.
Individual themes may provide alternate implementations
of these elements, as well as additional theme-specific elements.
IMPORTANT NOTICE: THIS IS A DRAFT DOCUMENT DESCRIBING FUTURE PLANS.
IT DOES NOT DESCRIBE HOW THINGS CURRENTLY WORK.
- text
- Displays a textual label, determined by the -text option.
Supports -font,
-foreground,
-width,
-wraplength,
-anchor,
-justify,
and -underline options.
- image
- Displays a Tk image, determined by the -image option.
- label
- This element combines the text and image elements.
The relative arrangement is determined by the -compound option.
- button
- Displays the push button (background area) of a ttk::button widget.
(WAS: "Button.border" in some themes, "Button.button" in
- radio
- Displays the on/off indicator for ttk::radiobutton widgets.
(WAS: Radiobutton.indicator)
- check
- Displays the on/off indicator for ttk::checkbutton widgets.
(WAS: Checkbutton.indicator)
- background
- The background element is treated specially.
It's automatically included as the first element in widget layouts
and need not be specified explicitly.
It is responsible for painting the widget background.
- fill
- Fills its parcel with a solid color.
- border
- Used in ttk::frame, ttk::label widgets, among others.
- padding
- focus
- A dashed focus ring, typically drawn around the label.
- field
-
(used in entry widgets; possibly to be replaced with 'border')
- client
- A placeholder element; used in ttk::notebook widgets
to determine the position and size of subpanes,
and in ttk::treeview widgets to determine the location
of the client area.
- textarea
- A placeholder element; used in ttk::entry and ttk::combobox widgets.
(possibly to be replaced with 'client'.)
- tab
-
- track
- The visible part of the scrollbar or scale background.
- trough
- A placeholder element, used to define the area
in which the thumb, slider, or progress bar moves.
Generally does not have a visual representation;
this is provided by the track.
- thumb
- The movable part of a scrollbar widget.
The scrollbar adjusts the position and size of the thumb
within the trough.
- slider
- The movable part of a ttk::scale widget.
The widget adjusts the position of the slider
within the trough.
- progress
- The resizable part of a ttk::progress widget.
(WAS: pbar).
- uparrow
- downarrow
- leftarrow
- rightarrow
- Used in scrollbars and spinboxes.
- spinbutton
- Combined up/down arrows; used in the TSpinbox layout in some themes.
- grip
- A grip
(vgrip, hgrip TBR)
- indicator
- Menubutton.indicator
Menubutton.dropdown (xpTheme.c only)
- separator
- sizegrip
- sash
- (new: WAS: hsash, vsash)
- disclosure
- The open/close indicator displayed to the left of tree items.
(WAS: Treeitem.indicator)
- heading
- (WAS: Treeheading.border, Treeheading.cell in aqua Theme)
- cell
- The background area of a data cell.
- row
- The background area of a row (NOTE: might be subsumed by "cell")
- The Radiobutton.indicator, Checkbutton.indicator,
and Treeitem.indicator elements have been renamed to
radio, check, and disclosure, respectively.
- The naming convention for ``oriented'' elements has been
revised and standardized. This affects the scrollbar, scale,
separator, and progressbar widgets.
- The Treeheading.border element has been renamed
to heading.
- The semantics of track and trough elements
has been clarified.