ttk::button - Widget that issues a command when pressed
Contents
Description
A ttk::button widget displays a textual label and/or image, and evaluates a command when pressed.
Keywords
widget, button, default, command
Tk 8.5 ttk::button(3tk)
Name
ttk::button - Widget that issues a command when pressed
See Also
ttk::widget(3tk), button(3tk)
Standard Options
-class-compound-cursor-image-justify-state-style-takefocus-text-textvariable-underline-width
See the ttk_widget manual entry for details on the standard options.
Standard Styles
Ttk::button widgets support the Toolbutton style in all standard themes, which is useful for creating
widgets for toolbars.
In the Aqua theme there are several other styles which can be used to produce replicas of many of the
different button types that are discussed in Apple's Human Interface Guidelines. These include
DisclosureButton, DisclosureTriangle, HelpButton, ImageButton, InlineButton, GradientButton,
RoundedRectButton, and RecessedButton.
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:
-anchoranchor-backgroundcolor-bordercolorcolor-compoundcompound-darkcolorcolor-foregroundcolor-fontfont-highlightcolorcolor-highlightthicknessamount-lightcolorcolor-paddingpadding-reliefrelief-shiftreliefamount-shiftrelief specifies how far the button contents are shifted down and right in the pressed
state. This action provides additional skeuomorphic feedback.
-widthamount
Some options are only available for specific themes.
See the ttk::style manual page for information on how to configure ttk styles.
Synopsis
ttk::buttonpathName ?options? ________________________________________________________________________________________________________________
Widget Command
In addition to the standard cget, configure, identifyelement, instate, state and style commands (see
ttk::widget), button widgets support the following additional commands:
pathNameinvoke
Invokes the command associated with the button.
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
<Enter>”). 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 normal.
Depending on the theme, the default button may be displayed with an extra highlight ring, or with
a different border color.
