ttk::radiobutton(n) Tk Themed Widget ttk::radiobutton(n)

```

```

# [NAME](#NAME)

ttk::radiobutton - Mutually exclusive option widget

# [SYNOPSIS](#SYNOPSIS)

**ttk::radiobutton pathName** ?*options*?

```

```

# [DESCRIPTION](#DESCRIPTION)

**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.

# [STANDARD OPTIONS](#STANDARD_OPTIONS)

```
-class	-compound	-cursor
-image	-state	-style
-takefocus	-text	-textvariable
-underline	-width
```

See the **ttk\_widget** manual entry for details on the standard options.

# [WIDGET-SPECIFIC OPTIONS](#WIDGET-SPECIFIC_OPTIONS)

```
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**.

# [WIDGET COMMAND](#WIDGET_COMMAND)

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*](#pathname)

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.

# [WIDGET STATES](#WIDGET_STATES)

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.)

# [STANDARD STYLES](#STANDARD_STYLES)

**Ttk::radiobutton** widgets support the **Toolbutton** style in all standard themes, which is useful for creating widgets for toolbars.

# [STYLING OPTIONS](#STYLING_OPTIONS)

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.

# [SEE ALSO](#SEE_ALSO)

[ttk::widget(n)](/man/os/tk/ttk::widget.n), [ttk::checkbutton(n)](/man/os/tk/ttk::checkbutton.n), [radiobutton(n)](/man/os/tk/radiobutton.n)

# [KEYWORDS](#KEYWORDS)

widget, button, option

8.5 Tk

---

Document: ttk_radiobutton(n) from tk 9.1.0-r0 (Chainguard OS)
Source: https://downloads.sourceforge.net/sourceforge/tcl/tk9.1.0-src.tar.gz