ttk::button manual page - Tk Themed Widget

Tcl8.6.10/Tk8.6.10 Documentation > Tk Commands > ttk_button

Tcl/Tk Applications | Tcl Commands | Tk Commands | [incr Tcl] Package Commands | SQLite3 Package Commands | TDBC Package Commands | tdbc::mysql Package Commands | tdbc::odbc Package Commands | tdbc::postgres Package Commands | tdbc::sqlite3 Package Commands | Thread Package Commands | Tcl C API | Tk C API | [incr Tcl] Package C API | TDBC Package C API

NAME
ttk::button — Widget that issues a command when pressed
SYNOPSIS
DESCRIPTION
STANDARD OPTIONS
-class, undefined, undefined
-compound, compound, Compound
-cursor, cursor, Cursor
-image, image, Image
-state, state, State
-style, style, Style
-takefocus, takeFocus, TakeFocus
-text, text, Text
-textvariable, textVariable, Variable
-underline, underline, Underline
-width, width, Width
WIDGET-SPECIFIC OPTIONS
-command, command, Command
-default, default, Default
WIDGET COMMAND
pathName invoke
STANDARD STYLES
STYLING OPTIONS
SEE ALSO
KEYWORDS

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, undefined, undefined
-compound, compound, Compound
-cursor, cursor, Cursor
-image, image, Image
-state, state, State
-style, style, Style
-takefocus, takeFocus, TakeFocus
-text, text, Text
-textvariable, textVariable, Variable
-underline, underline, Underline
-width, width, Width

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.

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.

STYLING OPTIONS

The class name for a ttk::button is TButton.

Dynamic states: active, disabled, pressed, readonly.

TButton styling options configurable with ttk::style are:

-anchor anchor
-background color
-bordercolor color
-compound compound
-darkcolor color
-foreground color
-font font
-highlightcolor color
-highlightthickness amount
-lightcolor color
-padding padding
-relief relief
-shiftrelief amount

-shiftrelief specifies how far the button contents are shifted down and right in the pressed state. This action provides additional skeumorphic feedback.
-width amount

Some options are only available for specific themes.

See the ttk::style manual page for information on how to configure ttk styles.

SEE ALSO

ttk::widget, button

KEYWORDS

widget, button, default, command
Copyright © 2004 Joe English