Python Tkinter Checkbutton

Python Tkinter Checkbutton 小部件用于向用户显示许多选项作为切换按钮。然后，用户可以通过单击与每个选项对应的按钮来选择一个或多个选项。

您还可以显示图像来代替文本。

语法

以下是创建此小部件的简单语法 -


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

参数

master - 这表示父窗口。
options − 这是此小部件最常用的选项列表。这些 options 可以用作用逗号分隔的键值对。

选项	描述
Activebackground	当 checkbutton 位于光标下时的背景颜色。
Activeforeground	当 checkbutton 位于光标下时的前景色。
Bg	显示在标签和指示器后面的正常背景色。
Bitmap	在按钮上显示单色图像。
Bd	指标周围边界的大小。默认值为 2 像素。
Command	每次用户更改此 checkbutton 的状态时要调用的过程。
Cursor	如果你将此选项设置为光标名称（箭头、点等），则鼠标光标在越过复选按钮时将变为该模式。
disabledforeground	用于呈现已禁用的 checkbutton 文本的前景色。默认值是默认前景色的点画版本。
Font	用于文本的字体。
Fg	用于呈现文本的颜色。
Height	checkbutton 上的文本行数。默认值为 1。
Highlightcolor	当 checkbutton 具有焦点时，焦点的颜色会突出显示。
Image	在按钮上显示图形图像。
Justify	如果文本包含多行，则此选项控制文本的两端对齐方式：CENTER、LEFT 或 RIGHT。
Offvalue	通常，当 checkbutton 的关联 control 变量被清除（off）时，它将设置为 0。您可以通过将 offvalue 设置为该值来为 off 状态提供备用值。
Onvalue	通常，当 checkbutton 的关联 control 变量被设置（on）时，它将设置为 1。您可以通过将 onvalue 设置为该值来为 on 状态提供替代值。
Padx	在复选按钮和文本的左侧和右侧留出多少空间。默认值为 1 像素。
Pady	在复选按钮和文本的上方和下方留出多少空间。默认值为 1 像素。
Relief	使用默认值 relief=FLAT 时，checkbutton 不会从其背景中突出显示。您可以将此选项设置为任何其他样式。
Selectcolor	设置复选按钮时的颜色。默认值为 selectcolor=“red”。
Selectimage	如果将此选项设置为图像，则该图像将在设置时显示在复选按钮中。
State	默认值为 state=NORMAL，但您可以使用 state=DISABLED 使控件变灰并使其无响应。如果光标当前位于复选按钮上，则状态为 ACTIVE。
Text	复选框旁边显示的标签。使用换行符（“\n”）显示多行文本。
Underline	使用默认值 -1 时，文本标签的任何字符都不会带下划线。将此选项设置为文本中字符的索引（从 0 开始计数），为该字符添加下划线。
Variable	跟踪 checkbutton 当前状态的 control 变量。通常这个变量是一个 IntVar，0 表示清除，1 表示设置，但请参阅上面的 offvalue 和 onvalue 选项。
Width	checkbutton 的默认宽度由显示的图像或文本的大小决定。您可以将此选项设置为多个字符，并且 checkbutton 将始终有空间容纳该字符许多角色。
Wraplength	通常，行不会换行。您可以将此选项设置为多个字符，所有行都将分成不超过该数字的片段。

方法

以下是此小部件的常用方法 -

方法	描述
deselect()	清除（关闭）复选按钮。
flash()	在活动颜色和正常颜色之间闪烁 checkbutton 几次，但保持开始时的状态。
invoke()	您可以调用此方法来获取与用户单击 checkbutton 更改其状态时发生的相同操作。
select()	设置（打开）复选按钮。
toggle()	如果已设置，则清除 checkbutton，如果清除则设置它。

例

请自行尝试以下示例 -


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()

执行上述代码时，它会产生以下结果 -

打印本页