- NAME
- ttk::radiobutton — Mutually exclusive option widget
- 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
- -value, Value, Value
- -variable, variable, Variable
- WIDGET COMMAND
- pathname invoke
- WIDGET STATES
- STANDARD STYLES
- STYLING OPTIONS
- SEE ALSO
- KEYWORDS
ttk::radiobutton — Mutually exclusive option widget
ttk::radiobutton pathName ?options?
ttk::radiobutton widgets are used in groups to show or change
a set of mutually-exclusive options.
Radiobuttons are linked to a Tcl variable,
and have an associated value; when a radiobutton is clicked,
it sets the variable to its associated value.
- -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
- Command-Line Name: -command
- Database Name: command
- Database Class: Command
- A Tcl script to evaluate whenever the widget is invoked.
- Command-Line Name: -value
- Database Name: Value
- Database Class: Value
- The value to store in the associated -variable
when the widget is selected.
- Command-Line Name: -variable
- Database Name: variable
- Database Class: Variable
- The name of a global variable whose value is linked to the widget.
Default value is ::selectedButton.
In addition to the standard
cget, configure, identify element, instate,
state and style
commands (see ttk::widget),
radiobutton widgets support the following additional commands:
- pathname invoke
-
Sets the -variable to the -value, selects the widget,
and evaluates the associated -command.
Returns the result of the -command, or the empty
string if no -command is specified.
The widget does not respond to user input if the disabled state is set.
The widget sets the selected state whenever
the linked -variable is set to the widget's -value,
and clears it otherwise.
The widget sets the alternate state whenever the
linked -variable is unset.
(The alternate state may be used to indicate a
“tri-state”
or
“indeterminate”
selection.)
Ttk::radiobutton widgets support the Toolbutton style in all
standard themes, which is useful for creating widgets for toolbars.
The class name for a ttk::radiobutton is TRadiobutton.
Dynamic states: active, alternate, disabled,
pressed, readonly, selected.
TRadiobutton styling options configurable with ttk::style
are:
-background color
-compound compound
-foreground color
-indicatorbackground color
-indicatorcolor color
-indicatormargin padding
-indicatorrelief relief
-padding padding
Some options are only available for specific themes.
See the ttk::style manual page for information on how to configure
ttk styles.
ttk::widget, ttk::checkbutton, radiobutton
widget, button, option
Copyright © 2004 Joe English