第15.29节 PyQt(Python+Qt)入门学习：containers容器类部件QScrollArea滚动区域详解

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

1、概述

Scroll Area提供了一个呈如今其余部件上的可滚动区域视图，滚动区域用于显示框架内的子部件的内容。实际上在Designer中设计部件的部署时，须要提供滚动区域的部件应该放在Scroll Area部件上。
下图是将一个标签文本放到滚动区域之上：

下图是该标签对应区域：

能够看到标签的区域在滚动区域以内。html

2、滚动区域相关的概念

在学习滚动区域时，老猿才开始觉得很简单，属性才两个，结果发现本身被打脸了，测试时发现alignment属性在Designer中没有做用，滚动条的出现以及内容的完整展示都不尽如人意，期间针对部分状况（如《PyQt（Python+Qt）学习随笔：QScrollArea为何不起做用未出现滚动条？》）弄清楚告终果在某些时候又不必定正确，这种状况持续整整三天多没有进展。python

为了解决问题，一方面查找资料，一方面继续各类测试，最后受《QT的自动滚动区QScrollArea的用法，图文详解》一文的启发最终才完全弄明白。web

2.一、滚动区域图例

Designer滚动区域部件对应类QScrollArea，但与QScrollArea有所区别，在此必须介绍一下滚动区域相关的几个重要概念。
下图是一个用Designer设计的能够明确滚动区域相关概念的界面图：

上图最下面是一个主窗口，在主窗口上面部署了一个Scroll Area的组件（为红色框围住的②号区域），滚动区域内部又存在一个蓝色边框标记的①号区域，能够看到Designer中1号区域是在2号区域内，但①号区域外②号区域内的部分与①号区域的背景是不一样的，①号区域的背景是由小点组成的网格，①号区域外②号区域内的部分则是无点的。框架

2.二、图例相关状况及概念说明

1. 上述①号区域和②号区域不彻底重叠只有在Scroll Area组件的widgetResizable为False时才会出现
   • 当部署完滚动区域且设置widgetResizable为未勾选且设置了滚动区域的布局后，将窗口调整大小后才会出现①号区域和②号区域不彻底重叠的状况
   • 调大窗口时①号区域在②号区域内，调小窗口时②号区域在①号区域内；
   • ①号区和②号区域重叠的范围由滚动区域布局的alignment属性确认，如选择对齐方式为左边和顶部对齐，则是左上角的范围重叠。
2. ②号区域是滚动区域部件可见的的总体范围，老猿将其称为展示层，实际上该层就是滚动区域部件的框架层；
3. ①号区域是滚动区域上的子部件部署范围，老猿称为内容部署层，子部件只能在内容部署层部署，不能在内容部署层外的展示层内部署；
4. 内容部署层实际上也是一个独立的部件，在Designer中的该部件在转成应用代码后，名字通常命名为“scrollAreaWidgetContents”或“scrollAreaWidgetContentsXX”（XX表示序号），所以该部件能够称为“滚动区域部件内容”，能够经过滚动区域部件的widget（）方法获取到内容部署层对应的部件，进而进一步访问相关属性；
5. 展示层的大小与滚动区域部件的框架大小一致，并跟随滚动区域的大小变化而变化；
6. 当展示层范围大于等于内容部署层大小时，操做者无需滚动便可看到完整的滚动区域部署部件；当展示层横向或纵向范围小于内容部署层对应方向大小时，则滚动区域只能展示部分滚动区域部署部件，其余部分须要展示层滚动后才可见；
7. 在滚动策略设置为按需展示滚动条（ScrollBarAsNeeded）时，只有当展示层的宽（或高）小于内容部署层的宽（或高）时才会出现水平（或竖直）滚动条；
8. 下面是几种展示层和内容部署层不一样场景的截图：
   
   
   
   
   
   
   这里就不穷举全部的模式了。

2.三、滚动区域的属性

基于上面介绍的滚动区域相关概念，咱们再来介绍滚动区域的属性。svg

2.3.一、概述

滚动区域对应类为QScrollArea，该类是从QAbstractScrollArea派生的，除了继承父类的属性外，在Designer中，QScrollArea滚动区域能够设置的自身的属性包括alignment和widgetResizable两个，除了Designer中的这2个属性外，内容部署层对应部件以及滚动区域的布局也是一重要属性。布局

2.3.二、alignment 属性

滚动区域的alignment属性对应QScrollArea的alignment属性，用于控制滚动区域的内容部署层相对展示层的对齐方式，分为水平和竖直两个方向。对齐方式对应类型为枚举类型Qt.Alignment ，相关取值及含义请参考《PyQt(Python+Qt)学习随笔：QListView的itemAlignment属性》。学习

各类对齐方式的案例请参考概念部分的截图案例。测试

能够经过alignment()和setAlignment(Qt.Alignment)方法对QScrollArea的alignment属性进行访问，对QScrollArea的alignment属性的缺省值为左上角对齐，表示内容层在展示层的左上角。.net

2.3.三、widgetResizable 属性

滚动区域的widgetResizable属性用于控制滚动区域的内容部署层是否应跟随滚动区域的大小变化进行大小跟随调整，当滚动区域框架（即展示层）大小小于内容部署层大小时，须要经过滚动窗口才能看到完整的内容部署层上的内容。设计

当滚动区域的widgetResizable 属性为False时，在Designer中或应用界面手工调整滚动区域部件的大小时，内容部署层不会跟随调整，但能够经过应用代码进行调整，具体调整方法请见下面介绍。

当滚动区域的widgetResizable 属性为True时，在Designer中或应用界面手工调整滚动区域部件的大小时，内容部署层会跟随调整。但老猿验证widgetResizable 为True时，此时经过应用代码进行调整调整滚动区域部件的大小没有任何效果。

滚动区域的widgetResizable属性缺省为False，能够经过方法widgetResizable()和setWidgetResizable(bool resizable)来访问widgetResizable属性。

2.3.四、内容部署部件属性

内容部署部件即为滚动区域的内容部署层对应部件，能够经过方法widget（）和setWidget(QWidget widget)来进行该属性的访问，方法takeWidget()能够将滚动区域对应的内容部署层对应部件移除。

2.3.五、滚动区域的布局属性

滚动区域自带布局属性，经过鼠标右键点击滚动区域部件，选择下图中的layout子菜单便可设置滚动区域的布局：

滚动区域的布局结合部署在滚动区域部件的大小策略，能够有效展示子部件的内容。如：

上图中的文本标签是代码生成的超长文本串，若是滚动区域不支持布局，则哪怕扩展滚动区域大小+滚动视图也没法显示完整的标签文本。如图：

广告

老猿关于PyQt的付费专栏《使用PyQt开发图形界面Python应用》只须要9.9元，该部分与第十五章的内容基本对应，但一样内容在付费专栏上整体来讲更详细、案例更多。本节内容对应付费专栏的《第二十四章、containers容器类部件QScrollArea滚动区域详解》。若是有兴趣也愿意支持老猿的读者，欢迎购买付费专栏。

老猿Python，跟老猿学Python!

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