NAME

tbutton -
Widget that issues a command when pressed

SYNOPSIS

tbutton pathName ?options?

STANDARD OPTIONS

OPTIONS

NameDatabase nameDatabase class
-commandcommandCommand
 A script to evaluate when the widget is invoked.
-defaultdefaultDefault
 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 disabled.
Depending on the theme, the default button may be displayed with an extra highlight ring, or with a different border color.
-texttextText
 Specifies a text string to be displayed inside the widget (unless overridden by -textvariable).
-textvariabletextVariableVariable
 Specifies the name of variable, whose value will be used in place of the -text resource.
-underlineunderlineUnderline
 Specifies the integer index (0-based) of a character to underline in the widget. The underlined character is used for mnemonic activation (see keynav(n)).
-widthwidthWidth
 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.
-imageimageImage
 Specifies an image to display.
-compoundcompoundCompound
 Specifies how to display the image relative to the text, in the case both -text and -image are present. Valid values are:
text
Display text only.
image
Display image only.
center
Display text centered on top of image.
top
bottom
left
right
Display image above, below, left of, or right of the text, respectively.
none
The default; display the image if present, otherwise the text.

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

NameDatabase nameDatabase class
-statestateState
 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