Python 3 - botão de verificação Tkinter

O widget Checkbutton é usado para exibir uma série de opções para um usuário como botões de alternância. O usuário pode então selecionar uma ou mais opções clicando no botão correspondente a cada opção.

Você também pode exibir imagens no lugar de texto.

Sintaxe

Aqui está a sintaxe simples para criar este widget -

w = Checkbutton ( master, option, ... )

Parâmetros

master - Isso representa a janela pai.
options- Aqui está a lista das opções mais comumente usadas para este widget. Essas opções podem ser usadas como pares de valores-chave separados por vírgulas.

Sr. Não.	Opção e descrição
1	activebackground Cor de fundo quando o botão de seleção está sob o cursor.
2	activeforeground Cor do primeiro plano quando o botão de seleção está sob o cursor.
3	bg A cor de fundo normal exibida atrás do rótulo e do indicador.
4	bitmap Para exibir uma imagem monocromática em um botão.
5	bd O tamanho da borda ao redor do indicador. O padrão é 2 pixels.
6	command Um procedimento a ser chamado toda vez que o usuário altera o estado deste botão de verificação.
7	cursor Se você definir esta opção para um nome de cursor ( seta, ponto, etc.), o cursor do mouse mudará para aquele padrão quando estiver sobre o botão de seleção.
8	disabledforeground A cor de primeiro plano usada para renderizar o texto de um botão de seleção desativado. O padrão é uma versão pontilhada da cor de primeiro plano padrão.
9	font A fonte usada para o texto.
10	fg A cor usada para renderizar o texto.
11	height O número de linhas de texto no botão de verificação. O padrão é 1.
12	highlightcolor A cor do foco é realçada quando o botão de seleção tem o foco.
13	image Para exibir uma imagem gráfica no botão.
14	justify Se o texto contiver várias linhas, esta opção controla como o texto é justificado: CENTRO, ESQUERDA ou DIREITA.
15	offvalue Normalmente, a variável de controle associada a um botão de verificação será definida como 0 quando for apagada (desligada). Você pode fornecer um valor alternativo para o estado desligado definindo offvalue para esse valor.
16	onvalue Normalmente, a variável de controle associada a um botão de verificação será definida como 1 quando for ativada. Você pode fornecer um valor alternativo para o estado ligado, definindo onvalue para esse valor.
17	padx Quanto espaço deixar à esquerda e à direita do botão de verificação e do texto. O padrão é 1 pixel.
18	pady Quanto espaço deve ser deixado acima e abaixo do botão de verificação e do texto. O padrão é 1 pixel.
19	relief Com o valor padrão, relief = FLAT, o botão de seleção não se destaca de seu fundo. Você pode definir esta opção para qualquer um dos outros estilos
20	selectcolor A cor do botão de verificação quando ele é definido. O padrão é selectcolor = "red".
21	selectimage Se você definir esta opção para uma imagem, essa imagem aparecerá no botão de seleção quando for definida.
22	state O padrão é state = NORMAL, mas você pode usar state = DISABLED para esmaecer o controle e torná-lo sem resposta. Se o cursor estiver atualmente sobre o botão de seleção, o estado é ATIVO.
23	text O rótulo exibido próximo ao botão de verificação. Use novas linhas ("\ n") para exibir várias linhas de texto.
24	underline Com o valor padrão de -1, nenhum dos caracteres do rótulo de texto é sublinhado. Defina esta opção para o índice de um caractere no texto (contando de zero) para sublinhar esse caractere.
25	variable A variável de controle que rastreia o estado atual do botão de verificação. Normalmente esta variável é um IntVar , e 0 significa limpo e 1 significa definido, mas consulte as opções offvalue e onvalue acima.
26	width A largura padrão de um botão de seleção é determinada pelo tamanho da imagem ou texto exibido. Você pode definir esta opção para vários caracteres e o botão de verificação sempre terá espaço para esse número de caracteres.
27	wraplength Normalmente, as linhas não são quebradas. Você pode definir esta opção para um número de caracteres e todas as linhas serão quebradas em partes não maiores que esse número.

Métodos

A seguir estão os métodos comumente usados para este widget -

Sr. Não.	Medthod e descrição
1	deselect() Limpa (desliga) o botão de verificação.
2	flash() O botão de seleção pisca algumas vezes entre suas cores ativas e normais, mas deixa do jeito que começou.
3	invoke() Você pode chamar esse método para obter as mesmas ações que ocorreriam se o usuário clicasse no botão de seleção para alterar seu estado.
4	select() Define (liga) o botão de verificação.
5	toggle() Limpa o botão de verificação se definido, define-o se desmarcado.

Exemplo

Experimente o seguinte exemplo -

# !/usr/bin/python3
from tkinter import *

import tkinter
    
top = Tk()
CheckVar1 = IntVar()
CheckVar2 = IntVar()
C1 = Checkbutton(top, text = "Music", variable = CheckVar1, \
                 onvalue = 1, offvalue = 0, height=5, \
                 width = 20, )
C2 = Checkbutton(top, text = "Video", variable = CheckVar2, \
                 onvalue = 1, offvalue = 0, height=5, \
                 width = 20)
C1.pack()
C2.pack()
top.mainloop()

Resultado

Quando o código acima é executado, ele produz o seguinte resultado -

↰ Previous page