| ActiveTcl User Guide |

Table of Contents

______________________________________________________________________________

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

## Standard Options

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

See the options manual entry for details on the standard options.

## 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 nor-mal. 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).

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

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

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

widget(n) , keynav(n)

## Keywords

widget, button, default, command

tile 0.2 button(n)

Table of Contents

- Name
- Synopsis
- Description
- Standard Options
- Options
- Widget Command
- Compatibility Options
- See Also
- Keywords