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

1、引言

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

2、QScrollBar滚动条部件

2.一、概述

Horizontal Scroll Bar和Vertical Scroll Bar都是滚动条部件,实际上这2个部件对应同一个类QScrollBar。在须要从QAbstractItemView派生子类提供滚动条时,QScrollBar很是适合,但若是须要在另外一个部件上提供滚动视图,不建议直接使用QScrollBar,而是使用QScrollArea类更方便,由于它同时提供了一个视口部件和滚动条部件。对于大多数使用滑块控件获取给定范围内的值的其余状况,使用QSlider类更适合。python

QScrollBar是从QAbstractSlider类派生的,自己除了构造方法外,并无特殊属性和方法。所以本部分介绍的属性、非构造方法、信号、槽方法实际上都是QAbstractSlider的。web

2.二、滚动条的部件组成

滚动条一般包括四个独立的控件:1个滑块、2个滚动箭头和1个页面控件。编程

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

2.三、滚动条的重要属性

  • 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.四、重要的方法、信号和槽方法

  • actionTriggered(int action):这个信号是滑块动做触发,用于告知是进行了单步增或减移动、按页增或减移动、移动到最大值、移动到最小值、或移动过程当中,发出信号时,滑块位置已根据操做进行了调整,但该值还没有传播(valueChanged()信号还没有发出),而且视觉显示还没有更新。所以,在链接到该信号的插槽中,能够根据动做和滑块的值,经过本身调用setSliderPosition()来安全地调整任何动做
  • triggerAction(SliderAction action)方法:这个一个方法,触发一个滑块移动事件,相似于模拟一个滑块移动操做,会发射actionTriggered()信号
  • setValue(int):槽方法,调整滚动条的值
  • sliderMoved(int value):此信号在滚动条滑块被按住且滚动条进行移动时发出,通常是拖拽滚动条时发出
  • sliderPressed():此信号在滚动条被鼠标按住,或者程序执行代码setSliderDown(True)时发出
  • sliderReleased():此信号在滚动条松开鼠标按住,或者程序执行代码setSliderDown(False)时发出
  • valueChanged(int value):此信号在滚动条值变动时发出

3、QSlider滑动条部件

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

QSlider滑动条部件功能简介
  • 能够设置滑条是否显示刻度以及刻度的位置,该功能经过属性tickPosition来控制
  • 能够设置刻度线之间的距离,该距离经过tickInterval属性控制

除了以上两个功能外,QSlider滑动条部件的其余方法、信号所有是父类的,如:app

  • 能够调用父类QAbstractSlider的方法setValue()将滑块直接设置为某个值
  • 能够调用父类QAbstractSlider的方法triggerAction()模拟单击的效果
  • 能够调用父类QAbstractSlider的方法setSingleStep(),setPageStep()设置移动的步长

4、QDial刻度盘部件

4.一、概述

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

刻度盘的键盘操做至关简单:左键/上键和右键/下键按定义的单步移动指针和改变值,PgUp和PgDn按定义的页面步向上和向下移动指针和调整值,Home键和End键将移动指针到最小值和最大值。ide

若是使用鼠标滚轮调整刻度盘,则增量值由 wheelScrollLines乘以singleStep和pageStep的较小值肯定。svg

4.二、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!