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 ttk_widget 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), button(3tk)

KEYWORDS

       widget, button, default, command