- class QDial#
QDial类实现了圆形范围控件(如速度表或电位器)。更多信息...
概述#
属性#
notchSize
- 当前缺口大小notchTarget
- 缺口之间的像素目标数notchesVisible
- 是否显示缺口wrapping
- 是否启用环绕
方法#
def
__init__()
def
notchSize()
def
notchTarget()
虚拟方法#
槽函数#
备注
此文档可能包含自动从C++转换为Python的代码片段。我们始终欢迎对代码片段翻译的贡献。如果您发现翻译有问题,您也可以通过在https:/bugreports.qt.io/projects/PYSIDE上创建票证来告诉我们
详细说明#
QDial
在用户需要在程序定义的范围内控制一个值时使用,范围可以是循环的(例如,角度测量从0度到359度)或者对话框布局需要一个方形小部件。因为
QDial
继承自QAbstractSlider
,旋钮的行为与slider
类似。当wrapping()
为false(默认设置)时,滑块和旋钮之间实际上没有真正的区别。它们共享相同的信号、槽和成员函数。您使用哪一个取决于用户的期望和应用程序的类型。旋钮最初在滑块被移动时连续发出
valueChanged()
信号;您可以通过禁用tracking
属性来降低信号的发出频率。即使禁用了跟踪,也会持续发出sliderMoved()
信号。当鼠标按钮按下和释放时,旋钮还会发出
sliderPressed()
和sliderReleased()
信号。请注意,即使没有发出这些信号,旋钮的值也可以改变,因为键盘和滚轮也可以用来改变值。与滑块不同,
QDial
尝试绘制尽可能多的“美观”刻度,而不是每行一步一个。如果可能的话,每行一步绘制一个刻度,但如果像素不足,QDial
将跳过一些刻度以尝试绘制一组均匀的刻度(例如,每隔一个或两个刻度绘制)。与滑块类似,拨盘将
QAbstractSlider
函数setValue()
作为槽提供。拨盘的键盘界面相对简单:左/上箭头和右/下箭头键通过已定义的
singleStep
调整拨盘的value
,Page Up 和 Page Down 通过已定义的pageStep
,Home 和 End 键将值设置到定义的minimum
和maximum
之间。如果您正在使用鼠标轮调整拨盘,增量值由小于
wheelScrollLines
乘以singleStep
和pageStep
的值来决定。另请参阅
备注
当使用
from __feature__ import true_property
时,可以直接使用属性,否则通过访问器函数。-
属性
notchSize: int
#
此属性保存当前刻度大小。
凹口大小以范围控制单位表示,而不是像素,并将其计算为一个
singleStep()
的倍数,该倍数导致屏幕上的凹口大小接近notchTarget()
。- 访问函数
- 属性notchTarget⁼: float#
此属性包含凹口之间像素的目标数量。
凹口目标是QString attempts to put between each notch.
实际大小可能与目标大小不同。
默认凹口目标为3.7像素。
- 属性notchesVisible⁼: bool#
此属性包含是否显示凹口。
如果属性为
true
,则在转盘周围绘制一系列凹口以表示可用的值范围;否则不显示凹口。默认情况下,此属性是禁用的。
- 属性wrapping⁼: bool#
此属性包含是否启用循环。
如果为true,则启用循环;否则在转盘底部插入一些空间,以分隔有效值范围的端点。
如果启用,箭头可以在转盘上的任何角度定位。如果禁用,箭头将限制在转盘的上部;如果将其旋转到底部空间中,则将其夹到最接近的有效值范围端点。
默认情况下此属性为
false
。- 访问函数
构建一个转盘。
parent
参数传递给QAbstractSlider
构造函数。- initStyleOption(option)#
- 参数:
选项 –
QStyleOptionSlider
使用此
QDial
的值初始化option
。该方法对于子类来说非常有用,当它们需要一个QStyleOptionSlider
,但又不想自己填写所有信息时。另请参阅
- notchSize()#
- 返回类型:
int
属性
notchSizeᅟ
的获取器。- notchTarget()#
- 返回类型:
float
另请参阅
属性
notchTargetᅟ
的获取器。- notchesVisible()#
- 返回类型:
bool
另请参阅
属性
notchesVisibleᅟ
的获取器。- setNotchTarget(target)#
- 参数:
target – float
另请参阅
- setNotchesVisible(visible)#
- 参数:
visible – bool
另请参阅
属性
notchesVisibleᅟ
的设置器。- setWrapping(on)#
- 参数:
on – bool
另请参阅
属性
wrappingᅟ
的设置器。- wrapping()#
- 返回类型:
bool
另请参阅
属性
wrappingᅟ
的获取器。