PyQt(Python+Qt)学习随笔:QDial刻度盘部件功能简介

时间:2024-06-19 14:35:20

一、概述

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的案例,大家可以回过头去看下。

PyQt(Python+Qt)学习随笔:QDial刻度盘部件功能简介PyQt(Python+Qt)学习随笔:QDial刻度盘部件功能简介

跟老猿学Python、学5G!