---
name: "button"
section: "3tcl"
platform: "linux"
package: "tk-tile"
version: "0.8.2-2.1"
release: "Debian 6.0 (Squeeze)"
platforms: ["linux"]
url: "https://new.carta.tech/button"
---

# button(3tcl)

Widget that issues a command when pressed

## NAME

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

## SYNOPSIS

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

## DESCRIPTION

A **button** widget displays a textual label and/or image, and evaluates a command when pressed. -class	-compound	-cursor	-image -state	-style	-takefocus	-text	 -textvariable	-underline	-width

## OPTIONS

\[**-command** *command Command*\] A script to evaluate when the widget is invoked. \[**-default** *default 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. See also: *keynav(n)*. \[**-width** *width 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

- *pathName* **invoke**

  Invokes the command associated with the button.

- *pathName* **cget** *option*

  - *pathName* **configure** ?*option*? ?*value option value ...*?

  - *pathName* **instate** *statespec* ?*script*?

  - *pathName* **state** ?*stateSpec*?

  See *widget(n)*

## COMPATIBILITY OPTIONS

\[**-state** *state 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

widget(n), keynav(n)

## KEYWORDS

widget, button, default, command