## NAME

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.

## STANDARD OPTIONS

## OPTIONS

Name | Database name | Database class
--- | --- | ---
-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

Name | Database name | Database class
--- | --- | ---
-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