PyQt（Python+Qt）学习随笔：QDial刻度盘部件功能简介

一、概述

Designer中的Dial刻度盘输入部件提供一个圆形的刻度表，类似速度表，对应类为QDial类。QDial继承自QAbstractSlider（关于QAbstractSlider的功能请参考《PyQt（Python+Qt）学习随笔：QScrollBar以及QAbstractSlider滚动条部件功能详解》），因此刻度盘与滑动条类似。当wrapping属性值为False（默认设置）时，刻度盘和滑动条之间除了外观外没有真正的区别。它们共享相同的信号、插槽和成员函数。关于滑动条的功能请参考《PyQt（Python+Qt）学习随笔：QSlider滑动条部件功能简介》。

刻度盘的键盘操作相当简单：左键/上键和右键/下键按定义的单步移动指针和改变值，PgUp和PgDn按定义的页面步向上和向下移动指针和调整值，Home键和End键将移动指针到最小值和最大值。

如果使用鼠标滚轮调整刻度盘，则增量值由 wheelScrollLines乘以singleStep和pageStep的较小值确定。

二、QDial拨号盘部件的属性、方法和信号

QDial刻度盘部件的独有属性如下：

wrapping属性：wrapping用于控制刻度盘上的刻度是否前后连接，如果为False，则最小值和最大值中间会有一段空白区域进行分隔，使用光标键调节值时指针只能在最小值和最大值之间移动，到达最大值或最小值时无法再朝对应方向移动。用鼠标拖拽指针可以越过最大值或最小值进行循环移动，但指针不能在空白区域段停留。如果wrapping为True，则指针移动到最大值或最小值时可以继续向对应方向移动，数值则跳转到最小值或最大值
notchesVisible属性：notchesVisible用于控制刻度盘上刻度线是否可见，可见时刻度线在表盘上平均分布
notchTarget属性：notchTarget用于控制刻度盘上刻度线之间的像素数量，表盘上刻度线的数量与4个属性相关，分别是最小值minimum、最大值maximum、singleStep单步数值以及notchTarget属性值，如果考虑notchTarget的值后表盘上的空间足够，刻度线的数量等于（maximum-minimum+1）/singleStep后四舍五入取整的值（假设为count），如果notchTarget设置过大导致count*notchTarget的值超过整个表盘的周长像素数，则只会绘制部分刻度线

除了构造方法以及上述属性的访问方法外，QDial的其他属性、方法和信号都是从父类派生的，比较重要的包括：

当刻度盘的指针移动时，刻度盘最初会连续发出valueChanged（）信号和sliderMoved（）信号，可以通过禁用跟踪属性使其发出valueChanged（）信号的频率降低，但sliderMoved（）信号不受影响
当拖拽指针移动时，按下和释放鼠标按钮时，刻度盘还会发出sliderPressed（）和sliderReleased（）信号
与滑动条一样，刻度表可以使用QAbstractSlider的setValue（）槽方法。

在《第15.35节 PyQt编程实战：结合QDial实现的QStackedWidget堆叠窗口程序例子》介绍了一个QDial的案例，大家可以回过头去看下。

跟老猿学Python、学5G!