---
name: "ttk::button"
section: "3tk"
platform: "linux"
package: "tk8.5-doc"
version: "8.5.19-1"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/ttk::button"
---

# ttk::button(3tk)

Widget that issues a command when pressed

```

```

## 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 evaluates a command when pressed.

## STANDARD OPTIONS

```
-class	-compound	-cursor
-image	-state	-style
-takefocus	-text	-textvariable
-underline	-width
```

See the  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 \<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.

```
Command-Line Name:	-width
Database Name:	width
Database Class:	Width
```

-

  If greater than zero, specifies how much space, in character widths,  to allocate for the text label.   If less than zero, specifies a minimum width. If zero or unspecified, the natural width of the text label is used. Note that some themes may specify a non-zero **-width** in the style.

## WIDGET COMMAND

In addition to the standard  **cget**, **configure**, **identify**, **instate**, and **state**  commands, buttons support the following additional widget commands:

- *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.

## COMPATIBILITY OPTIONS

```
Command-Line Name:	-state
Database Name:	state
Database Class:	State
```

-

  May be set to **normal** or **disabled** to control the **disabled** state bit. This is a “write-only” option: setting it changes the widget state, but the **state** widget command does not affect the state option.

## SEE ALSO

[ttk::widget(3tk)](/ttk::widget/3tk.md), [button(3tk)](/button/3tk.md)

## KEYWORDS

widget, button, default, command