Checkbutton

btn = ttk.Checkbutton(parent, option=value, ...)

Atributos

OpçãoDescrição
class_Nome da classe do componente.
commandServe para definir uma função que será chamada sempre que o estado do checkbutton muda.
compoundCaso o checkbutton tenha imagem e texto, esta opção serve para posicionar a imagem relativamente ao texto. Os valores podem ser: tk.TOP – imagem sobre o texto, tk.BOTTOM – imagem por debaixo do texto, tk.LEFT – imagem à esquerda do texto ou tk.RIGHT – imagem à direita do texto. Se o botão tiver imagem e texto mas esta opção não fôr definida, só aparecerá a imagem.
cursorCursor mostrado quando o rato está sobre o componente.
imageDefinir uma imagem que aparecerá no checkbutton.
offvalueQuando um checkbutton está no estado desmarcado (off), o valor da variável definida na opção variable é 0. Podemos definir aqui outro valor para este estado.
onvalueQuando um checkbutton está no estado marcado (on), o valor da variável definida na opção variable é 1. Podemos definir aqui outro valor para este estado.
styleEstilo usado na visualização do componente.
takefocusPara impedir que o componente aceite foco via teclado, fazer takefocus=False.
textDefine o texto que aparece no checkbutton.
textvariableVariável do tipo StringVar que controla o texto do checkbutton.
underlineEspecifica o índice do caratere do texto que aparecerá sublinhado. Exemplo: para um valor 4, o caratere com o índice 4 será sublinhado.
variableDefine uma variável que controla o estado do checkbutton, normalmente uma variável IntVar, cujo valor, sendo 0, o checkbutton está no estado desmarcado (off) e sendo 1, o checkbutton está no estado marcado (on).
widthDefine o número carateres do texto. Se fôr um valor positivo é um tamanho fixo. Se fôr um valor negativo é um tamanho mínimo.

Métodos

Os métodos do Checkbutton são todos os comuns a todos os componentes ttk, mais o seguinte:

.invoke() : Chama a função definida na opção command, caso esta esteja definida.

Exemplo:

from tkinter import *
from tkinter import ttk

window = Tk()
window.title("Tkinter - ttk Checkbutton")
window.geometry("200x100")

def check():
    if pt:
        print("Pt checked")
    if en:
        print("En checked")
    if fr:
        print("Fr checked")

pt = IntVar()
pt.set(1)
en = IntVar()
fr = IntVar()

chk = ttk.Checkbutton(window, text="Pt", variable=pt)
chk.pack()
chk = ttk.Checkbutton(window, text="En", variable=en)
chk.pack()
chk = ttk.Checkbutton(window, text="Fr", variable=fr)
chk.pack()

window.mainloop()