57-tkinter-ttkbootstrap-widgets小部件模块

widgets小部件模块

DateEntry日期条目

ttkbootstrap.widgets.DateEntry (Frame)
日期条目小部件将 和 a 与附加到函数的回调相结合。ComboboxButtonget_date

按下时，将显示日期选择器弹出窗口。返回的 值将插入到组合框中。

日期选择器弹出窗口将使用组合框中的日期作为 焦点日期（如果采用参数指定的格式）。默认情况下，此格式为“%Y-%m-%d”。dateformat

引导样式 API 可用于更改小部件的样式。 可用颜色包括 ->主要、次要、成功、 信息， 警告， 危险， 光， 黑暗.

可以更改日期选择器弹出窗口的开始工作日 与参数。默认情况下，此值为 ，表示“星期日”。firstweekday6

可以从 和 属性访问 和 小部件。EntryButtonDateEntry.EntryDateEntry.Button

__init__

__init__(self, 
         master=None, 
         dateformat='%x', 
         firstweekday=6, 
         startdate=None, 
         bootstyle='', 
         **kwargs) special

参数：

名字	类型	描述	违约
master	Widget	父小组件。	None
dateformat	str	用于呈现条目中文本的格式字符串 控件。有关可接受格式的详细信息，请参阅 https://strftime.org/	'%x'
firstweekday	int	指定一周的第一天。0=星期一，1=星期二， 等。。。	6
startdate	datetime	显示小组件时处于焦点的日期。默认值为 当前日期。	None
bootstyle	str	用于设置条目焦点颜色的样式关键字 和日期按钮的背景色。可用 选项包括 ->主要、辅助、成功、信息、 警告，危险，黑暗，光明。	''
**kwargs	Dict[str, Any]	传递给包含 条目和日期按钮。	{}

configure(self, cnf=None, **kwargs)

配置此微件的选项。

参数：

名字	类型	描述	违约
cnf	Dict[str, Any]	配置选项的字典。	None
**kwargs		可选关键字参数。	{}

Floodgauge水池进度条

ttkbootstrap.widgets.Floodgauge (Progressbar)

显示长时间运行的操作的状态的小组件 带有可选的文本指示器。

与 类似，此小部件可以在 两种模式。确定模式显示已完成的金额 相对于要完成的总工作量，不确定模式提供动画显示，让 用户知道正在发生某些事情。

ttk.Progressbar变量是为此小部件自动生成的，可以是 通过 和 属性引用其他小部件链接到它们。textvariablevariable

例子：

import ttkbootstrap as ttk
from ttkbootstrap.constants import *

app = ttk.Window(size=(500, 100))

gauge = ttk.Floodgauge(bootstyle=INFO,
                       font=(None, 24, 'bold'),
                       mask='Memory Used {}%')

gauge.place(relx=0.01, rely=0.25, relwidth=0.98, relheight=0.5)

# autoincrement the gauge
gauge.start()

# stop the autoincrement
gauge.stop()

# manually update the gauge value
gauge.configure(value=25)

# increment the value by 10 steps
gauge.step(10)

app.mainloop()

属性	说明
textvariable	返回文本变量对象, 属性可写
variable	返回变量对象, 属性可写

__init__

__init__(self, 
         master=None, 
         cursor=None, 
         font=None, 
         length=None, 
         maximum=100, 
         mode='determinate', 
         orient='horizontal', 
         bootstyle='primary', 
         takefocus=False, 
         text=None, 
         value=0, 
         mask=None, 
         **kwargs) special

参数：

名字	类型	描述	违约
master	Widget	父小部件。默认为“无”。	None
cursor	str	当鼠标悬停在 进度条。默认为“无”。	None
font	Union[Font, str]	用于进度栏标签的字体。	None
length	int	指定进度条长轴的长度 （如果方向 = 水平，则宽度，如果垂直，则高度）;	None
maximum	float	指定最大值的浮点数。 默认值为 100。value	100
mode	'determinate', 'indeterminate'	如果无法准确测量 基础流程的相对进度。在这种模式下， 矩形在 使用该方法后的小部件。 否则，如果相对进度可以 提前计算。indeterminate``Floodgauge.start()``determinate	'determinate'
orient	'horizontal', 'vertical'	指定小组件的方向。	'horizontal'
bootstyle	str	用于呈现微件的样式。选项包括 主要， 次要， 成功， 信息， 警告， 危险， 光， 黑暗。	'primary'
takefocus	bool	默认情况下，此微件不包含在焦点遍历中。 要将微件添加到焦点遍历，请使用 。takefocus=True	False
text	str	要在“洪水计”标签中显示的文本字符串。 这是分配给属性的Floodgauge.textvariable	None
value	float	进度条的当前值。在模式下，这表示已完成的工作量。在模态下，它被解释为模; 也就是说，当进度条增加 .determinate``indeterminate``maximum``value``maximum	0
mask	str	可用于更新流量计的字符串格式 每次更新值时标记。例如， 小部件值为 45 的字符串“{}% 已用存储”将 在 Floodgauge 标签上显示“45% 已使用存储空间”。如果 设置了掩码，则忽略该选项。text	None
**kwargs		选项数据库中的其他配置选项。	{}

configure(self, cnf=None, **kwargs)

配置此微件的选项。

参数：

名字	类型	描述	违约
cnf	Dict[str, Any]	配置选项的字典。	None
**kwargs		可选关键字参数。	{}

Meter仪表盘

ttkbootstrap.widgets.Meter (Frame)
可用于显示长 正在运行的操作或完成的工作量;也可以 设置为 时用作拨盘。interactive=True

这个小部件非常灵活。有两种主要的仪表类型 可以使用参数设置：“full”和 “semi”，以完整或 半圆。您还可以使用 和参数。metertypearcrangearcoffset

仪表指示器可以显示为纯色或 使用参数的条带。默认情况下，为 0，这将产生实心仪表 指示器。更高的结果是更大的楔块 围绕仪表的弧线。stripethicknessstripethicknessstripethickness

存在各种文本和标签选项。中心文本和 仪表指示器使用参数进行格式化。 您可以在此中心标签的左侧和右侧设置文本 使用 和 参数。这是最 通常用于“$”、“%”或其他此类符号。meterstyletextlefttextright

如果需要访问更新计量的变量，则 您可以通过 、 、 和 .这些属性的值也可以是 通过该方法检索。amountusedvaramounttotalvarlabelvarconfigure

例子：

import ttkbootstrap as ttk
from ttkbootstrap.constants import *

app = ttk.Window()

meter = ttk.Meter(metersize=180,
                  padding=5,
                  amountused=25,
                  metertype="semi",
                  subtext="miles per hour",
                  interactive=True)
meter.pack()

# update the amount used directly
meter.configure(amountused=50)

# update the amount used with another widget
entry = ttk.Entry(textvariable=meter.amountusedvar)
entry.pack(fill=X)

# increment the amount by 10 steps
meter.step(10)

# decrement the amount by 15 steps
meter.step(-15)

# update the subtext
meter.configure(subtext="loading...")

app.mainloop()

--init--

__init__(self,
         master=None, 
         bootstyle='default', 
         arcrange=None, 
         arcoffset=None, 
         amounttotal=100, 
         amountused=0, 
         wedgesize=0, 
         metersize=200, 
         metertype='full', 
         meterthickness=10, 
         showtext=True, 
         interactive=False, 
         stripethickness=0, 
         textleft=None, 
         textright=None, 
         textfont='-size 20 -weight bold', 
         subtext=None, 
         subtextstyle='default', 
         subtextfont='-size 10', 
         stepsize=1, 
         **kwargs)

参数：

名字	类型	描述	违约
master	Widget	父小组件。	None
arcrange	int	弧的范围（如果从开始到结束的度数）。	None
arcoffset	int	偏移圆弧起始位置的量（以度为单位）。 0 在 3 点钟位置。	None
amounttotal	int	仪表的最大值。	100
amountused	int	仪表的当前值;显示在中心标签中 如果该属性设置为 True。showtext	0
wedgesize	int	设置指示器楔块围绕圆弧的长度。如果 大于 0，此楔形设置为以指标为中心 在当前仪表值上。	0
metersize	int	仪表是方形的。这表示一侧的大小 如果以屏幕单位测量的正方形。	200
bootstyle	str	设置指示器和中心文本颜色。主要之一， 次要， 成功， 信息， 警告， 危险， 光明， 黑暗.	'default'
metertype	'full', 'semi'	将仪表显示为全圆或半圆。	'full'
meterthickness	int	指示器的粗细。	10
showtext	bool	指示是否显示左侧、中间和右侧文本 仪表上的标签。	True
interactive	bool	指示用户可以通过以下方式调整仪表值 鼠标交互。	False
stripethickness	int	指标可以显示为实心带或 弧形周围的条纹楔形。如果该值大于 0，指标从实心变为条纹，其中 值是条纹（或楔形）的厚度。	0
textleft	str	插入到中间文本左侧的短字符串。	None
textright	str	插入到中心文本右侧的短字符串。	None
textfont	Union[str, Font]	用于呈现中心文本的字体。	'-size 20 -weight bold'
subtext	str	显示在中心文本下方的补充文本。	None
subtextstyle	str	潜台词的引导样式颜色。主要之一， 次要， 成功， 信息， 警告， 危险， 光明， 黑暗. 默认颜色是特定于主题的，并且颜色较浅 阴影基于它是“浅色”还是“深色”主题。	'default'
subtextfont	Union[str, Font]	用于呈现潜台词的字体。	'-size 10'
stepsize	int	设置更改计量指示器的量 当通过鼠标交互递增时。	1
**kwargs		直接传递给包含计量组件的小组件的其他关键字参数。Frame	{}

configure(self, cnf=None, **kwargs)

配置此微件的选项。

参数：

名字	类型	描述	违约
cnf	Dict[str, Any]	配置选项的字典。	None
**kwargs		可选关键字参数。	{}

step(self, delta=1)

将指标值增加delta

指示器将反转方向并倒计时一次 达到最大值。

参数：

名字	类型	描述	违约
delta	int	更改指标的量。	1