ttk::button(3tk) Tk Themed Widget ttk::button(3tk)
______________________________________________________________________________
NAME
ttk::button - Widget that issues a command when pressed
SYNOPSIS
ttk::button pathName ?options?
______________________________________________________________________________
DESCRIPTION
A ttk::button widget displays a textual label and/or image, and evalu-
ates a command when pressed.
STANDARD OPTIONS
-class -compound -cursor
-image -state -style
-takefocus -text -textvariable
-underline -width
See the ttk_widget manual entry for details on the standard options.
WIDGET-SPECIFIC OPTIONS
Command-Line Name:-command
Database Name: command
Database Class: Command
A script to evaluate when the widget is invoked.
Command-Line Name:-default
Database Name: default
Database Class: Default
May be set to one of normal, active, or disabled. In a dialog
box, one button may be designated the “default” button (meaning,
roughly, “the one that gets invoked when the user presses <En-
ter>”). active indicates that this is currently the default
button; normal means that it may become the default button, and
disabled means that it is not defaultable. The default is nor-
mal.
Depending on the theme, the default button may be displayed with
an extra highlight ring, or with a different border color.
WIDGET COMMAND
In addition to the standard cget, configure, identify, instate, and
state commands, buttons support the following additional widget com-
mands:
pathName invoke
Invokes the command associated with the button.
STANDARD STYLES
Ttk::button widgets support the Toolbutton style in all standard
themes, which is useful for creating widgets for toolbars.
STYLING OPTIONS
The class name for a ttk::button is TButton.
Dynamic states: active, disabled, pressed, readonly.
TButton styling options configurable with ttk::style are:
-anchor anchor
-background color
-bordercolor color
-compound compound
-darkcolor color
-foreground color
-font font
-highlightcolor color
-highlightthickness amount
-lightcolor color
-padding padding
-relief relief
-shiftrelief amount
-shiftrelief specifies how far the button contents are shifted
down and right in the pressed state. This action provides addi-
tional skeumorphic feedback.
-width amount
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(3tk), button(3tk)
KEYWORDS
widget, button, default, command
Tk 8.5 ttk::button(3tk)
Generated by dwww version 1.14 on Thu Jan 23 00:08:19 CET 2025.