ttk::button(n) Tk Themed Widget ttk::button(n)

```

```

# [NAME](#NAME)

ttk::button - Widget that issues a command when pressed

# [SYNOPSIS](#SYNOPSIS)

**ttk::button pathName** ?*options*?

```

```

# [DESCRIPTION](#DESCRIPTION)

A **ttk::button** widget displays a textual label and/or image, and evaluates a command when pressed.

# [STANDARD OPTIONS](#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.

# [WIDGET-SPECIFIC 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 <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.

# [WIDGET COMMAND](#WIDGET_COMMAND)

In addition to the standard **cget**, **configure**, **identify element**, **instate**, **state** and **style** commands (see **ttk::widget**), button widgets support the following additional commands:

[*pathName invoke*](#pathName)

Invokes the command associated with the button.

# [STANDARD STYLES](#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](#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 additional skeuomorphic 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](#SEE_ALSO)

[ttk::widget(n)](/man/os/tk/ttk::widget.n), [button(n)](/man/os/tk/button.n)

# [KEYWORDS](#KEYWORDS)

widget, button, default, command

8.5 Tk

---

Document: ttk_button(n) from tk 9.0.4-r2 (Chainguard OS)
Source: https://downloads.sourceforge.net/sourceforge/tcl/tk9.0.4-src.tar.gz