PySide6.QtWidgets.QDial¶

class QDial¶

QDial 类提供了一个圆形的范围控制（如速度计或电位器）。更多…

概要¶

属性¶

• notchSizeᅟ - 当前的缺口大小

• notchTargetᅟ - 凹槽之间的目标像素数

• notchesVisibleᅟ - 是否显示凹槽

• wrappingᅟ - 是否启用换行

方法¶

• def __init__()

• def notchSize()

• def notchTarget()

• def notchesVisible()

• def setNotchTarget()

• def wrapping()

虚拟方法¶

• def initStyleOption()

插槽¶

• def setNotchesVisible()

• def setWrapping()

注意

本文档可能包含从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中的较小值决定。

另请参阅

QScrollBar QSpinBox QSlider 滑块示例

注意

当使用from __feature__ import true_property时，属性可以直接使用，否则通过访问器函数使用。

property notchSizeᅟ: int¶

此属性保存当前的缺口大小。

缺口大小以范围控制单位表示，而不是像素，并且计算为singleStep()的倍数，以在屏幕上产生接近notchTarget()的缺口大小。

另请参阅

notchTarget() singleStep()

Access functions:

• notchSize()

property notchTargetᅟ: float¶

此属性保存刻度之间的目标像素数。

缺口目标是QDial尝试在每个缺口之间放置的像素数。

实际大小可能与目标大小不同。

默认的缺口目标是3.7像素。

Access functions:

• notchTarget()

• setNotchTarget()

property notchesVisibleᅟ: bool¶

此属性控制是否显示凹口。

如果属性为true，则会在表盘周围绘制一系列刻度以指示可用值的范围；否则不显示刻度。

默认情况下，此属性是禁用的。

Access functions:

• notchesVisible()

• setNotchesVisible()

property wrappingᅟ: bool¶

此属性表示是否启用了换行。

如果为真，则启用换行；否则在刻度盘的底部插入一些空间以分隔有效值范围的端点。

如果启用，箭头可以在表盘上任意角度定向。如果禁用，箭头将被限制在表盘的上部；如果它旋转到表盘底部的空间，它将被限制在有效值范围的最接近的末端。

默认情况下，此属性为 false。

Access functions:

• wrapping()

• setWrapping()

__init__([parent=None])¶

Parameters:

父级 – QWidget

构造一个拨号盘。

parent 参数被发送到 QAbstractSlider 构造函数。

initStyleOption(option)¶

Parameters:

选项 – QStyleOptionSlider

使用此QDial中的值初始化option。当子类需要QStyleOptionSlider但不想自己填写所有信息时，此方法非常有用。

另请参阅

initFrom()

notchSize()¶

Return type:

整数

属性 notchSizeᅟ 的获取器。

notchTarget()¶

Return type:

浮点数

另请参阅

setNotchTarget()

属性 notchTargetᅟ 的获取器。

notchesVisible()¶

Return type:

布尔

另请参阅

setNotchesVisible()

属性 notchesVisibleᅟ 的获取器。

setNotchTarget(target)¶

Parameters:

target – 浮点数

另请参阅

notchTarget()

setNotchesVisible(visible)¶

Parameters:

visible – 布尔值

另请参阅

notchesVisible()

属性 notchesVisibleᅟ 的设置器。

setWrapping(on)¶

Parameters:

on – 布尔值

另请参阅

wrapping()

属性 wrappingᅟ 的设置器。

wrapping()¶

Return type:

布尔

另请参阅

setWrapping()

属性 wrappingᅟ 的获取器。