第15.44节、PyQt输入部件：QAbstractSlider派生类QScrollBar滚动条、QSlider滑动条、QDial刻度盘功能详解

• 专栏：Python基础教程目录
• 专栏：使用PyQt开发图形界面Python应用
• 专栏：PyQt入门学习
• 老猿Python博文目录
• 老猿学5G博文目录

一、引言

Designer中的输入部件Horizontal ScrollBar水平滚动条、Vertical ScrollBar垂直滚动条、Horizontal Slider水平滑动条、Vertical Slider垂直滑动条以及Dial刻度盘对应的类都是QAbstractSlider类的派生类。这些部件都可以表示在指定区间范围内的数值，并通过拖拽滑块或指针进行移动改变值。

二、QScrollBar滚动条部件

2.1、概述

Horizontal Scroll Bar和Vertical Scroll Bar都是滚动条部件，实际上这2个部件对应同一个类QScrollBar。在需要从QAbstractItemView派生子类提供滚动条时，QScrollBar非常适合，但如果需要在另一个部件上提供滚动视图，不建议直接使用QScrollBar，而是使用QScrollArea类更方便，因为它同时提供了一个视口部件和滚动条部件。对于大多数使用滑块控件获取给定范围内的值的其他情况，使用QSlider类更适合。

QScrollBar是从QAbstractSlider类派生的，本身除了构造方法外，并没有特殊属性和方法。因此本部分介绍的属性、非构造方法、信号、槽方法实际上都是QAbstractSlider的。

2.2、滚动条的部件组成

滚动条通常包括四个独立的控件：1个滑块、2个滚动箭头和1个页面控件。

• 滑块提供了快速转到文档任何部分的方法，但不支持在大型文档中进行精确导航
• 滚动箭头，滚动箭头是按钮，可用于精确导航到文档中的特定位置。对于连接到文本编辑器的垂直滚动条，这些滚动条通常将当前位置向上或向下移动一行，并将滑块的位置调整少量。在编辑器和列表框中，“行”可能意味着一行文本；在图像查看器中，它可能意味着20像素。
• 页面控件是拖动滑块的区域（滚动条的背景）。单击此处可将滚动条向单击方向移动一页。此值通常与滑块的长度相同。

2.3、滚动条的重要属性

• value属性：每个滚动条都有一个值，该值指示滑块距滚动条起点的距离，该值通过value（）获得，并通过setValue（）设置，value的值在minimum和maximum之间，可以使用setMinimum（）和setMaximum（）调整最小值和最大值
• singleStep属性：表示单步移动的距离，单步移动是指通过单次点击滚动箭头或按压移动光标键后滑块移动的距离
• pageStep属性：表示移动一页的距离，当按压上下翻页键或在滚动条上下点击鼠标移动的距离
• tracking属性： 当设置为True时，在拖拽滑块时就会发出valueChanged()信号，否则只有当终止拖拽释放鼠标时才发射该信号
• sliderPosition属性：滑块当前位置，如果tracking属性为True，则其值与value属性值相等
• orientation属性：表示是水平滚动条还是竖直滚动条
• invertedAppearance属性：此属性控制滑块是否反转显示其值。如果为False（默认值），则最小值和最大值将显示在部件的经典位置（如最小值在顶部或左边）。如果该值为真，则最小值和最大值将显示在它们的相反位置
• invertedControls属性：此属性保留滑块是否反转响应滚动事件和键盘事件。如果此属性为False，则滚动鼠标滚轮“向上”并使用诸如“PgUp”之类的键将滑块的值朝最大值增加。否则，按“PgUp”会将值向滑块的最小值靠近
• sliderDown属性：此属性用于确认滚动条滑块是否被按住

2.4、重要的方法、信号和槽方法

• actionTriggered(int action)：这个信号是滑块动作触发，用于告知是进行了单步增或减移动、按页增或减移动、移动到最大值、移动到最小值、或移动过程中，发出信号时，滑块位置已根据操作进行了调整，但该值尚未传播（valueChanged（）信号尚未发出），并且视觉显示尚未更新。因此，在连接到该信号的插槽中，可以根据动作和滑块的值，通过自己调用setSliderPosition（）来安全地调整任何动作
• triggerAction(SliderAction action)方法：这个一个方法，触发一个滑块移动事件，类似于模拟一个滑块移动操作，会发射actionTriggered（）信号
• setValue(int)：槽方法，调整滚动条的值
• sliderMoved(int value)：此信号在滚动条滑块被按住且滚动条进行移动时发出，一般是拖拽滚动条时发出
• sliderPressed()：此信号在滚动条被鼠标按住，或者程序执行代码setSliderDown(True)时发出
• sliderReleased()：此信号在滚动条松开鼠标按住，或者程序执行代码setSliderDown(False)时发出
• valueChanged（int value）：此信号在滚动条值变更时发出

三、QSlider滑动条部件

Horizontal Slider和Vertical Slider是用于通过移动滑块控制输入数字的滑动条部件，二者对应同一个类QSlider。滑动条部件提供垂直或水平滑动条。滑动条移动时，滑块所在的位置会转换为对应的数值。

QSlider滑动条部件功能简介

• 可以设置滑条是否显示刻度以及刻度的位置，该功能通过属性tickPosition来控制
• 可以设置刻度线之间的距离，该距离通过tickInterval属性控制

除了以上两个功能外，QSlider滑动条部件的其他方法、信号全部是父类的，如：

• 可以调用父类QAbstractSlider的方法setValue（）将滑块直接设置为某个值
• 可以调用父类QAbstractSlider的方法triggerAction（）模拟单击的效果
• 可以调用父类QAbstractSlider的方法setSingleStep（），setPageStep（）设置移动的步长

四、QDial刻度盘部件

4.1、概述

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

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

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

4.2、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!

• 专栏：Python基础教程目录
• 专栏：使用PyQt开发图形界面Python应用
• 专栏：PyQt入门学习
• 老猿Python博文目录
• 老猿学5G博文目录