第15.37节 PyQt(Python+Qt)入门学习:containers容器类部件QMdiArea多文档界面部件详解及编程开发案例

一、引言

老猿在前期学习PyQt相关知识时,对每个组件的属性及方法都研究得很透彻,并将学习的感悟都写成了博文,这种方式写了大量博文,但也耽误了太多时间,学习PyQt的时间已经超过了学习Python基础知识和爬虫的时间,而后面还有好多部件,必须得提速了,因此老猿决定以后每种部件都只简单介绍重要的特性和方法,不每个属性和方法都研究了,就从本文开始。

二、概述

QMdiArea部件提供一个包含MDI多文档窗口的区域,在这个区域内管理多个窗口,每个窗口都可以称为激活窗口,可以做自己的事情,如移动、最小化、关闭、打开自己的文档等,而QMdiArea支持对区域内的窗口进行层叠窗口或平铺窗口,并在子窗口切换激活窗口时发射信号。

三、常用属性、方法和信号

3.1、QMdiArea中的子窗口

3.1.1、增加子窗口

QMdiArea中的子窗口类型是QMdiSubWindow的实例,但可以使用addSubWindow()方法将任何QWidget或其派生类的实例添加到MDI区域作为子窗口,此时QMdiArea会自动创建子窗口的QMdiSubWindow实例,并作为addSubWindow()方法的结果返回。

3.1.2、子窗口数量

QMdiArea中的子窗口数量无法直接通过QMdiArea方法获取,必须先通过方法subWindowList()返回所有子窗口的列表,再通过Python的len函数获取子窗口的数量。

3.1.3、子窗口排序和排列

subWindowList()返回的子窗口列表是排序的,有三种排序方式,通过属性activationOrder来控制,排序方式由枚举类型QMdiArea.WindowOrder指定,可通过Designer中就可以设置的属性activationOrder来指定。当使用cascadeSubWindows()和tileSubWindows()层叠或平铺方式来排列区域内的窗口时,也会使用该排序。

3.1.4、活动子窗口

子窗口在获得键盘焦点或调用setFocus()时变为活动状态,用户通过以通常的方式移动焦点来激活窗口。当活动窗口更改时,MDI区域会发出subWindowActivated()信号,active subwindow()函数会返回活动子窗口,槽方法setActiveSubWindow(QMdiSubWindow window)在切换活动窗口时调用。

3.1.5、移除和关闭子窗口

可以通过removeSubWindow(QWidget widget)移除指定子窗口实例,也也可以通过调用槽方法closeAllSubWindows()、closeActiveSubWindow()来关闭子窗口,可以重写这两个方法对子窗口关闭进行相关处理。

3.2、viewMode属性

viewMode属性用于控制子窗口是使用子窗口模式(QMdiArea.SubWindowView)还是选项卡模式(QMdiArea.TabbedView)显示。

如果是子窗口模式,则每个子窗口都是一个带标题栏、窗口G根据addSubWindow指定flag可以设置最大化、最小化和关闭按钮的窗口,可以执行窗口关闭和大小的变化。

如果是选项卡模式,则子窗口最大化后不显示标题栏及操作按钮,但非最大化下会同样显示,另外所有窗口都会在选项卡栏上有个选项。如图:

第15.37节 PyQt(Python+Qt)入门学习:containers容器类部件QMdiArea多文档界面部件详解及编程开发案例

在选项卡模式下,窗口可以设置documentMode(是否支持文档模式,支持文档模式时窗口无框架,用更多的空间显示文档)、tabsClosable(在选项卡中是否显示关闭标志)、tabsMovable(各子窗口的选项卡在选项卡栏是否可以移动)、tabPosition(选项卡栏所在位置)、tabShape(选项卡形状)这几个属性,而在子窗口模式这几个属性无效。

另外,经老猿验证,在子窗口模式下添加的子窗口必须显示执行show()等方法才能显示子窗口,在选项卡模式无需执行show()等方法就可以显示子窗口。调用show方法时,既可以使用addSubWindow(widget)参数中的widget,也可以用方法返回值对应窗口。

3.3、subWindowActivated信号

subWindowActivated在一个窗口激活(获得焦点)时发射,语法如下:

  • subWindowActivated(QMdiSubWindow window)

如果window参数为None,则表示没有激活的子窗口,如果应用没有disable子窗口,则表示所有子窗口都关闭了。

这个信号比较有用,当开发的应用需要结合子窗口的个数来显示不同的状态时,可以通过这个信号判断window参数是否为None来设置不同的状态。

如下代码是将该信号连接一个槽方法,在槽方法中根据window参数设置actionclose对应按钮和菜单的状态:

    def __init__(self):
super().__init__()
self.setupUi(self)
self.mdiArea.subWindowActivated.connect(self.setButtonsStatus) def setButtonsStatus(self,win):
if win:self.actionclose.setEnabled(True)
else:self.actionclose.setEnabled(False)

四、案例

4.1、案例说明

老猿做了个QMidiArea的测试程序,在这个应用内,可以打开一次打开一个图像文件显示,如果打开的文件没有关闭,再打开就可以显示多个图像文件。

4.2、UI设计

界面为一个QMainWindow,带菜单、工具栏:

第15.37节 PyQt(Python+Qt)入门学习:containers容器类部件QMdiArea多文档界面部件详解及编程开发案例

从界面看到,包括了打开文件、关闭窗口、排列窗口等功能,下面窗口上部署了QMidiArea实例,没有在Designer中定义子窗口。另外定义了菜单对应action的triggered信号和槽方法的连接,注意级联窗口和平铺窗口直接连接的是QMidiArea的槽方法cascadeSubWindows和tileSubWindows()。

4.3、子窗口的设计

为了简单,子窗口复用了《第15.35节 PyQt编程实战:结合QDial实现的QStackedWidget堆叠窗口程序例子》中的ui_GraphicFileView.ui,相关界面及类graphicFileView在此不重复介绍。

4.4、主界面派生类

主界面派生类主要完成了如下工作:

  • 在构造方法连接了QMdiArea的subWindowActivated和槽方法
  • 实现槽方法setButtonsStatus,根据是否有子窗口设置两个关闭窗口的菜单和按钮的状态
  • 实现了打开图像文件的槽方法openGraphicFile,支持选择一个图片文件打开显示
  • 实现了关闭当前窗口的槽方法closeCurrentWindow
基础代码如下:
class mainWin(QtWidgets.QMainWindow,ui_mainWin.Ui_MainWindow):
def __init__(self):
super().__init__()
self.setupUi(self) self.mdiArea.subWindowActivated.connect(self.setButtonsStatus) def setButtonsStatus(self,win):
if win:
self.actionclose.setEnabled(True)
self.actioncloseAllWindow.setEnabled(True)
else:
self.actionclose.setEnabled(False)
self.actioncloseAllWindow.setEnabled(False) def closeCurrentWindow(self):
w = self.mdiArea.activeSubWindow()
if w: w.close() def openGraphicFile(self):
fileName = .....
......
w = graphicFileView.graphicFileView(fileName) win = self.mdiArea.addSubWindow(w)
win.show()

4.5、运行截图

第15.37节 PyQt(Python+Qt)入门学习:containers容器类部件QMdiArea多文档界面部件详解及编程开发案例

五、小结

本部分重点介绍了QMdiArea的用途、重要特性和方法、信号,我们在开发时,先做好UI设计,然后通过代码实现QMdiArea子窗口的管理,通过信号subWindowActivated判断QMdiArea实例内是否有可用子窗口来设置相关操作菜单的状态。具体使用可以参考案例。

广告

老猿关于PyQt的付费专栏《使用PyQt开发图形界面Python应用》只需要9.9元,该部分与第十五章的内容基本对应,但同样内容在付费专栏上总体来说更详细、案例更多。本节内容对应付费专栏的《第三十章、containers容器类部件QMdiArea多文档界面部件功能介绍及编程应用》。如果有兴趣也愿意支持老猿的读者,欢迎购买付费专栏。

第15.37节 PyQt(Python+Qt)入门学习:containers容器类部件QMdiArea多文档界面部件详解及编程开发案例

老猿Python,跟老猿学Python!

上一篇:C# 统计在线人数和总访问人数


下一篇:ssh 调优参数