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()
执行上述代码时,它会产生以下结果 -
![tkinter_checkbutton](/python/images/tkinter_checkbutton.jpg)