- 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, instate, and state commands,
radiobuttons support the following additional widget 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