第15.30节 PyQt编程实战：经过eventFilter监视QScrollArea的widget（）的Paint消息画出scrollAreaWidgetContents的范围矩形

• 老猿Python博文目录
• 专栏：使用PyQt开发图形界面Python应用
• 老猿Python博客地址

1、引言

在《PyQt（Python+Qt）学习随笔：QScrollArea滚动区域详解》介绍了滚动区域的展示层（也称框架层）和内容部署层：

1. 内容部署层实际上也是一个独立的部件，在Designer中的该部件在转成应用代码后，名字通常命名为“scrollAreaWidgetContents”或“scrollAreaWidgetContentsXX”（XX表示序号），所以该部件能够称为“滚动区域部件内容”
2. 内容部署层能够经过滚动区域部件的widget（）方法获取到内容部署层对应的部件；
3. 当展示层范围大于等于内容部署层大小时，操做者无需滚动便可看到完整的滚动区域部署部件；当展示层横向或纵向范围小于内容部署层对应方向大小时，则滚动区域只能展示部分滚动区域部署部件，其余部分须要展示层滚动后才可见；
4. 当滚动区域的widgetResizable属性为False时，内容部署层和展示层的大小不一致，内容部署层的视口范围在展示层的框架范围内，其不可见部分须要经过滚动条才能够拖拽显示。

因为内容部署层在程序运行时与展示层没有明确的可视界限，本文将在滚动区域上将内容部署层的范围使用红色边框的矩形绘制出来，以实时了解内容部署层的大小。

2、实现方案介绍

2.一、界面设计

整个程序界面设计以下：

在上述界面中：

• 最上面的选中的框架即为滚动区域部件的范围，也即展示层的范围
• 滚动区域框架内布满点的矩形范围即为内容部署层范围，也便是咱们要画矩形的范围
• 按钮“扩展滚动区域”是每次将内容部署层范围的宽和高加5个像素，将其链接界面类的槽方法resizeScrollArea
• 按钮“恢复滚动区域初始大小”是将滚动区域的内容部署层的大小恢复成初始化时的大小，将其链接界面类的槽方法restoreScrollArea
• 内容展示层的label文本标签是用来测试长文本在滚动区域展示状况的，在界面构造方法中将其初始化为固有文本加0到100的数字组成的文本

2.二、画矩形的实现

2.2.1 捕获scrollAreaWidgetContents的paint消息

1. 要在ui界面上的某部件A上画矩形，必须经过部件A的Paint消息处理中进行，这就须要截获部件A的paint消息。 关于消息捕获请参考《第15.17节 PyQt(Python+Qt)入门学习：PyQt图形界面应用程序的事件捕获方法大全及对比分析》。

2. 因为不想对UI界面的部件类进行子类化，所以消息捕获使用的是事件过滤方法；

3. 在捕获消息前先定义了消息监视类，用于监视scrollAreaWidgetContents的消息，类定义代码以下：

class eventMonitor(QtCore.QObject):
    def eventFilter(self, objwatched, event):
        eventType = event.type()

        flag = eventType == QtCore.QEvent.Paint

        if flag:
            self.mypaintEvent(objwatched)
            ret = False
        else:
            ret = super().eventFilter(objwatched, event)

        return ret

上述代码截获了objwatched对象的消息，并判断是否是Paint消息，若是是则调用方法mypaintEvent在objwatched的几何矩形范围的边框画一个矩形，不然直接将消息往上传递。

4. 实现mypaintEvent方法，在监视部件上画矩形

def mypaintEvent(self, parent):
        paint = QtGui.QPainter(parent)  #在对应部件上建立画笔
        ......
        paint.drawRect(geometry) #画对应大小的矩形

5. 从界面类派生自定义界面类
   从界面类派生自定义界面类，在构造方法中将标签文本赋予长文本并记下滚动区域内容部署层的初始大小，同时实现槽方法resizeScrollArea和restoreScrollArea。完整界面类代码以下：

class mainWin(ui_mainWin_scrollArea.Ui_mainWin,QtWidgets.QWidget):
    def __init__(self):
        super().__init__()
        self.setupUi(self)
        for i in range(100): #将label设置为增长了带0-99数字（空格分隔）的长文本
            self.label.setText(self.label.text()+str(i)+' ')
        self.scrollAreaInitSize = self.scrollArea.widget().size()  #记下滚动区域部件内容部署层的初始大小

6. 安装事件监视
   在主程序代码中安装事件监视。

monitorObj = eventMonitor()  # 建立事件刷选监视对象
    w.scrollArea.widget().installEventFilter(monitorObj)  # 对滚动区域内置展示层部件安装事件刷选

注意：在这里是在应用主程序代码安装的事件刷选，其实也能够在界面类内去安装事件刷选，不过安装时必须使用self.monitorObj来保存监视对象，不然方法一结束监视对象就会自动销毁。

3、运行观察

1. 初始界面
   
2. 点击6次扩展滚动区域后的界面
   
3. 继续点击扩展滚动区域直至高或宽有一份显示不完整
   
4. 继续点击扩展滚动区域直至高或宽都显示不完整
   
5. 拉伸主窗口到滚动区域的内容展示层从新完整展示
   
6. 继续点击扩展滚动区域观察滚动区域内容部署层的扩展状况
   
   经过以上运行观察，能够看到随着内容部署层的扩展，展现的label的文本内容愈来愈多，但除非一直扩展到能展现整个文本的内容的宽度，不然老是只能展现文本的内容部署层对应的宽度。但若是设置滚动区域的widgetResizable属性为True，则会在初始状态就能经过滚动条看到全部文本。

广告

老猿关于PyQt的付费专栏《使用PyQt开发图形界面Python应用》只须要9.9元，该部分与第十五章的内容基本对应，但一样内容在付费专栏上整体来讲更详细、案例更多。本节内容对应付费专栏的《PyQt编程实战：画出QScrollArea的scrollAreaWidgetContents内容部署层的范围矩形》。若是有兴趣也愿意支持老猿的读者，欢迎购买付费专栏。

老猿Python，跟老猿学Python!

• 老猿Python博文目录
• 专栏：使用PyQt开发图形界面Python应用
• 老猿Python博客地址