tk Radiobutton

See: https://www.geeksforgeeks.org/radiobutton-in-tkinter-python/

Usage

The tkinter.Radiobutton widget provides a Radio button.
To create a Radio button widget the general syntax is (assuming import via "import tkinter as tk"):
button_widget = tk.Radiobutton(parent, option=value)
parent is the window or frame object.
Options can be passed as parameters separated by commas.

Using radio buttons

tk_widget_interactions/images/radio_buttons.png

This code demonstrates the use of option buttons (radio buttons) and a text widget to display the selected option.

  1. Frame Creation: - A frame with a light blue background is created to hold the radio buttons.

  2. Option Variable: - A StringVar is created to hold the value of the selected option. - Initially, no default value is set.

  3. Radio Buttons: - Three radio buttons are created for the options "Option 1", "Option 2", and "Option 3". - The indicatoron option is set to 0 to make the radio buttons look like regular buttons. - The display_option function is called when a button is selected, updating the text widget with the selected option.

  4. Text Widget: - A text widget is created to display the selected option.

import tkinter as tk
from tkinter import font

def display_option():
    selected_option = option_var.get()
    text_widget.delete(1.0, 'end')
    text_widget.insert(tk.END, f"You selected: {selected_option}")

# Create the main window
root = tk.Tk()
root.title("Option Buttons")

# Create a frame with a background color
frame = tk.Frame(root, bg="light blue")
frame.pack(padx=10, pady=10, fill="both", expand=True)

# Define a font style
fontStyle = font.Font(family="Lucida Grande", size=18)

# Create a StringVar to hold the selected option
option_var = tk.StringVar(value=None)  # No default value

# Define the options
options = ["Option 1", "Option 2", "Option 3"]

# Create and pack the radio buttons
for option in options:
    button = tk.Radiobutton(frame, text=option, variable=option_var, value=option,
                             command=display_option, bg="white", fg="black",
                            font=fontStyle, indicatoron=0, padx=10, pady=5)
    button.pack(side="left", padx=5, pady=5)

# Create a text widget to display the selected option
text_widget = tk.Text(root, height=2, width=30, bg="white", fg="black",
                        font=fontStyle, bd=2, relief="solid")
text_widget.pack(padx=10, pady=10)

# Run the main event loop
root.mainloop()

Parameter syntax

radiobutton_widget = tk.Radiobutton(parent, option=value)
parent is the window or frame object.
Options can be passed as parameters separated by commas.

Parameters:

activebackground
Syntax: radiobutton_widget = tk.Radiobutton(parent, activebackground="color")
Description: Sets the background color of the radiobutton when it is active.
Default: SystemButtonFace
Example: radiobutton_widget = tk.Radiobutton(root, activebackground="lightblue")
activeforeground
Syntax: radiobutton_widget = tk.Radiobutton(parent, activeforeground="color")
Description: Sets the foreground color of the radiobutton when it is active.
Default: SystemWindowText
Example: radiobutton_widget = tk.Radiobutton(root, activeforeground="blue")
anchor
Syntax: radiobutton_widget = tk.Radiobutton(parent, anchor="position")
Description: Sets the anchor position for the text and indicator.
Default: center
Example: radiobutton_widget = tk.Radiobutton(root, anchor="w")
background
Syntax: radiobutton_widget = tk.Radiobutton(parent, background="color")
Description: Sets the background color of the radiobutton.
Default: SystemButtonFace
Example: radiobutton_widget = tk.Radiobutton(root, background="lightyellow")
bd
Syntax: radiobutton_widget = tk.Radiobutton(parent, bd=border_width)
Description: Sets the border width of the radiobutton.
Default: 2
Example: radiobutton_widget = tk.Radiobutton(root, bd=5)
bg
Syntax: radiobutton_widget = tk.Radiobutton(parent, bg="color")
Description: Sets the background color of the radiobutton.
Default: SystemButtonFace
Example: radiobutton_widget = tk.Radiobutton(root, bg="lightyellow")
bitmap
Syntax: radiobutton_widget = tk.Radiobutton(parent, bitmap="bitmap_name")
Description: Sets a bitmap image to be displayed on the radiobutton.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, bitmap="error")
borderwidth
Syntax: radiobutton_widget = tk.Radiobutton(parent, borderwidth=width)
Description: Sets the width of the border around the radiobutton.
Default: 2
Example: radiobutton_widget = tk.Radiobutton(root, borderwidth=3)
command
Syntax: radiobutton_widget = tk.Radiobutton(parent, command=function)
Description: Specifies a function to be called when the radiobutton is selected.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, command=my_function)
compound
Syntax: radiobutton_widget = tk.Radiobutton(parent, compound="position")
Description: Specifies how to display the image and text (if both are set).
Default: none
Example: radiobutton_widget = tk.Radiobutton(root, compound="left")
cursor
Syntax: radiobutton_widget = tk.Radiobutton(parent, cursor="cursor_type")
Description: Sets the mouse cursor when hovering over the radiobutton.
Default: arrow
Example: radiobutton_widget = tk.Radiobutton(root, cursor="hand2")
disabledforeground
Syntax: radiobutton_widget = tk.Radiobutton(parent, disabledforeground="color")
Description: Sets the foreground color when the radiobutton is disabled.
Default: SystemDisabledText
Example: radiobutton_widget = tk.Radiobutton(root, disabledforeground="gray")
fg
Syntax: radiobutton_widget = tk.Radiobutton(parent, fg="color")
Description: Sets the foreground color of the radiobutton (text color).
Default: SystemWindowText
Example: radiobutton_widget = tk.Radiobutton(root, fg="black")
font
Syntax: radiobutton_widget = tk.Radiobutton(parent, font=("font_name", size, "style"))
Description: Specifies the font type, size, and style for the text of the radiobutton.
Default: TkDefaultFont
Example: radiobutton_widget = tk.Radiobutton(root, font=("Arial", 12, "bold"))
foreground
Syntax: radiobutton_widget = tk.Radiobutton(parent, foreground="color")
Description: Sets the foreground color of the radiobutton (text color).
Default: SystemWindowText
Example: radiobutton_widget = tk.Radiobutton(root, foreground="black")
height
Syntax: radiobutton_widget = tk.Radiobutton(parent, height=value)
Description: Sets the height of the radiobutton.
Default: 0 (automatically determined)
Example: radiobutton_widget = tk.Radiobutton(root, height=2)
highlightbackground
Syntax: radiobutton_widget = tk.Radiobutton(parent, highlightbackground="color")
Description: Sets the background color of the radiobutton when it does not have focus.
Default: SystemButtonFace
Example: radiobutton_widget = tk.Radiobutton(root, highlightbackground="gray")
highlightcolor
Syntax: radiobutton_widget = tk.Radiobutton(parent, highlightcolor="color")
Description: Sets the color of the highlight when the radiobutton has focus.
Default: SystemWindowFrame
Example: radiobutton_widget = tk.Radiobutton(root, highlightcolor="blue")
highlightthickness
Syntax: radiobutton_widget = tk.Radiobutton(parent, highlightthickness=thickness)
Description: Sets the thickness of the highlight border.
Default: 1
Example: radiobutton_widget = tk.Radiobutton(root, highlightthickness=2)
image
Syntax: radiobutton_widget = tk.Radiobutton(parent, image="image_name")
Description: Sets an image to be displayed on the radiobutton.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, image=my_image)
indicatoron
Syntax: radiobutton_widget = tk.Radiobutton(parent, indicatoron=1)
Description: Specifies whether to show the indicator (true or false).
Default: 1
Example: radiobutton_widget = tk.Radiobutton(root, indicatoron=0)
justify
Syntax: radiobutton_widget = tk.Radiobutton(parent, justify="position")
Description: Sets the justification of the text (left, center, right).
Default: center
Example: radiobutton_widget = tk.Radiobutton(root, justify="right")
offrelief
Syntax: radiobutton_widget = tk.Radiobutton(parent, offrelief="style")
Description: Sets the relief style for the indicator when off.
Default: raised
Example: radiobutton_widget = tk.Radiobutton(root, offrelief="flat")
overrelief
Syntax: radiobutton_widget = tk.Radiobutton(parent, overrelief="style")
Description: Sets the relief style for the indicator when hovered over.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, overrelief="sunken")
padx
Syntax: radiobutton_widget = tk.Radiobutton(parent, padx=padding_value)
Description: Sets the horizontal padding within the radiobutton.
Default: 1
Example: radiobutton_widget = tk.Radiobutton(root, padx=10)
pady
Syntax: radiobutton_widget = tk.Radiobutton(parent, pady=padding_value)
Description: Sets the vertical padding within the radiobutton.
Default: 1
Example: radiobutton_widget = tk.Radiobutton(root, pady=10)
relief
Syntax: radiobutton_widget = tk.Radiobutton(parent, relief="style")
Description: Sets the border style of the radiobutton. Options include flat, raised, sunken, groove, ridge.
Default: flat
Example: radiobutton_widget = tk.Radiobutton(root, relief="raised")
selectcolor
Syntax: radiobutton_widget = tk.Radiobutton(parent, selectcolor="color")
Description: Sets the color of the indicator when the radiobutton is selected.
Default: SystemWindow
Example: radiobutton_widget = tk.Radiobutton(root, selectcolor="lightgreen")
selectimage
Syntax: radiobutton_widget = tk.Radiobutton(parent, selectimage="image_name")
Description: Sets an image to be displayed when the radiobutton is selected.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, selectimage=my_selected_image)
state
Syntax: radiobutton_widget = tk.Radiobutton(parent, state="state_type")
Description: Sets the state of the radiobutton. Options include normal, disabled, or active.
Default: normal
Example: radiobutton_widget = tk.Radiobutton(root, state="disabled")
takefocus
Syntax: radiobutton_widget = tk.Radiobutton(parent, takefocus=1)
Description: Allows the radiobutton to take focus on click.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, takefocus=1)
text
Syntax: radiobutton_widget = tk.Radiobutton(parent, text="label")
Description: Sets the text label for the radiobutton.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, text="Option 1")
textvariable
Syntax: radiobutton_widget = tk.Radiobutton(parent, textvariable=variable)
Description: Associates a variable with the text of the radiobutton.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, textvariable=my_text_var)
tristateimage
Syntax: radiobutton_widget = tk.Radiobutton(parent, tristateimage="image_name")
Description: Sets an image to be displayed for a tristate radiobutton.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, tristateimage=my_tristate_image)
tristatevalue
Syntax: radiobutton_widget = tk.Radiobutton(parent, tristatevalue=value)
Description: Sets the value for the tristate option of the radiobutton.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, tristatevalue=2)
underline
Syntax: radiobutton_widget = tk.Radiobutton(parent, underline=index)
Description: Specifies the index of the character to underline in the text.
Default: -1 (no underline)
Example: radiobutton_widget = tk.Radiobutton(root, underline=0)
value
Syntax: radiobutton_widget = tk.Radiobutton(parent, value=radio_value)
Description: Sets the value associated with this radiobutton when selected.
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, value=1)
variable
Syntax: radiobutton_widget = tk.Radiobutton(parent, variable=control_variable)
Description: Associates the radiobutton with a control variable (e.g., IntVar, StringVar).
Default: None
Example: radiobutton_widget = tk.Radiobutton(root, variable=my_var)
width
Syntax: radiobutton_widget = tk.Radiobutton(parent, width=width_value)
Description: Sets the width of the radiobutton.
Default: 0 (automatically determined)
Example: radiobutton_widget = tk.Radiobutton(root, width=30)
wraplength
Syntax: radiobutton_widget = tk.Radiobutton(parent, wraplength=pixel_value)
Description: Sets the maximum line length for text in pixels.
Default: 0 (no wrapping)
Example: radiobutton_widget = tk.Radiobutton(root, wraplength=100)