Checkbutton
btn = ttk.Checkbutton(parent, option=value, ...)
Atributos
Opção | Descrição |
---|---|
class_ | Nome da classe do componente. |
command | Serve para definir uma função que será chamada sempre que o estado do checkbutton muda. |
compound | Caso 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. |
cursor | Cursor mostrado quando o rato está sobre o componente. |
image | Definir uma imagem que aparecerá no checkbutton. |
offvalue | Quando 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. |
onvalue | Quando 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. |
style | Estilo usado na visualização do componente. |
takefocus | Para impedir que o componente aceite foco via teclado, fazer takefocus=False. |
text | Define o texto que aparece no checkbutton. |
textvariable | Variável do tipo StringVar que controla o texto do checkbutton. |
underline | Especifica o índice do caratere do texto que aparecerá sublinhado. Exemplo: para um valor 4, o caratere com o índice 4 será sublinhado. |
variable | Define 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). |
width | Define 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()
