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] A script to evaluate when the widget is invoked.  [-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] 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] 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(3tcl)