What is Checkbutton Widget?

The Checkbutton widget is used to implement on / off selections. A Checkbutton can contain Text, Image and similar to normal buttons we can associate Python function to this widget which gets called whenever the user pressed the button.

Example

The following Python script creates a window that contains one Checkbutton with a text “Turn On”. One method is associated with this check button so whenever you clicked on it, It calls the functions and inside the function, we can implement our own logic.

You need to write following code in any text editor and then save it with .py extension. To execute the application, Type python CheckButtonExample.py command in terminal.

from tkinter import *

# Top level window 
window = Tk()

window.title("Studyfied.com")
window.geometry('350x200')

toggleState = IntVar()

# Python function associated with 'checkbutton'
def toggle():
    print("Toggle", toggleState.get())    

# A CheckButton
checkbutton = Checkbutton(window, text="Turn On", command=toggle, variable=toggleState)
checkbutton.pack()

window.mainloop()

Output

The above code produces the following output in windows operating system.

Explanation

Following line creates a Tkinter window

from tkinter import *

window = Tk()

window.title("Studyfied.com")
window.geometry('350x200')

See explanation of Tkinter window – Tkinter top level window

It is a python function which is associated with our check button. Whenever function gets called it prints the current state of check button 1 or 0.

# Python function associated with 'checkbutton'
def toggle():
    print("Toggle", toggleState.get())

This snippet creates a check button widget, the first parameter is the name of the parent window. Here it is “window”. The second parameter is text which is used to set some text to be displayed on Check button, the third parameter is used to set action command for this button which is ‘toggle’, toggle() is defined just above of this line, and the last parameter is Tk integer variable to monitor the current state of Check button.

# A CheckButton
checkbutton = Checkbutton(window, text="Turn On", command=toggle, variable=toggleState)
checkbutton.pack()

The second line checkbutton.pack(), is geometry manager that packs widgets into rows or columns.

Some checkbutton properties