PyQt5高级窗口控件详解：停靠窗口、多文档界面与滚动条

掌握PyQt5的高级窗口控件，让你的GUI应用具备专业级的布局与交互体验

在PyQt5应用开发中，高效管理窗口布局和实现复杂交互功能是提升用户体验的关键。本文将深入解析三个核心高级控件：停靠窗口（QDockWidget）、多文档界面（MDI）和滚动条（QScrollBar），通过代码示例带你快速掌握它们的实战应用。

QDockWidget：灵活可停靠的窗口控件

QDockWidget是PyQt5中用于创建可停靠子窗口的核心控件，它可以在主窗口内自由浮动或停靠在指定区域，为专业级应用提供灵活的布局方案。

QDockWidget的使用

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

class DockDemo(QMainWindow):
    def __init__(self,parent=None):
        super(DockDemo,self).__init__(parent)
        layout=QHBoxLayout()
        bar=self.menuBar()
        file=bar.addMenu("File")
        file.addAction("New")
        file.addAction("save")
        file.addAction("quit")
        self.items=QDockWidget("Dockable",self)
        self.listWidget=QListWidget()
        self.listWidget.addItem("item1")
        self.listWidget.addItem("item2")
        self.listWidget.addItem("item3")
        self.items.setWidget(self.listWidget)
        self.items.setFloating(False)
        self.setCentralWidget(QTextEdit())
        self.addDockWidget(Qt.RightDockWidgetArea,self.items)
        self.setLayout(layout)
        self.setWindowTitle("Dock 例子")

if __name__ == '__main__':
    app=QApplication(sys.argv)
    demo=DockDemo()
    demo.show()
    sys.exit(app.exec_())

运行结果

MDI多文档界面：高效管理多个子窗口

MDI（Multiple Document Interface）允许在单个主窗口容器内管理多个文档窗口，相比独立的SDI窗口，它能显著节省系统资源并提供更集成的用户体验。

QMdiArea核心方法

一个典型的GUI应用程序可能有多个窗口，选项卡控件和堆栈窗口控件允许一
次使用其中的一个窗口。然而，很多时候这种方法不是很有用，因为其他窗口的视
图是隐藏的。

一种同时显示多个窗口的方法是，创建多个独立的窗口，这些独立的窗口被称
为SDI（SingleDocumentlnterface,单文档界面），每个窗口都可以有自己的菜单系
统、工具栏等。这需要占用较多的内存资源。

MDI（Multiple Document lnterface，多文档界面）应用程序占用较少的内存资
源，子窗口都可以放在主窗口容器中，这个容器控件被称为QMdiArea。

QMidArea控件通常占据在QMainWindow对象的中央位置，了窗口在这个区域
是QMdiSubWindow类的实例，可以设置任何QWidget作为子窗口对象的内部控件，
子窗口在MDI区域进行级联排列布局。

QMdiArea类和QMdiSubWindow类中的常用方法如表5-16所示。

多重文档界面

import sys
from PyQt5.QtWidgets import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *

class MainWindow(QMainWindow):
    count=0
    def __init__(self,parent=None):
        super(MainWindow,self).__init__(parent)
        self.mdi=QMdiArea()
        self.setCentralWidget(self.mdi)
        bar=self.menuBar()
        file=bar.addMenu("File")
        file.addAction("New")
        file.addAction("cascade")
        file.addAction("Tiled")
        file.triggered[QAction].connect(self.windowaction)
        self.setWindowTitle("MDI demo")

    def windowaction(self,q):
        print("triggered")

        if q.text()=="New":
            MainWindow.count=MainWindow.count+1
            sub=QMdiSubWindow()
            sub.setWidget(QTextEdit())
            sub.setWindowTitle("subwindow"+str(MainWindow.count))
            self.mdi.addSubWindow(sub)
            sub.show()

        if q.text()=="cascade":
            self.mdi.cascadeSubWindows()
        if q.text()=="Tiled":
            self.mdi.tileSubWindows()

if __name__ == '__main__':
    app=QApplication(sys.argv)
    demo=MainWindow()
    demo.show()
    sys.exit(app.exec_())

运行结果

QScrollBar：实现精确的滚动控制

QScrollBar不仅提供基本的滚动功能，还能作为交互式控件用于数值调整，特别适合需要精确控制的场景（如颜色选择器）。

核心信号说明

QScrollBar
​

import sys
from PyQt5.QtCore import *
from PyQt5.QtGui import *
from PyQt5.QtWidgets import *
​
class Example(QWidget):
    def __init__(self):
        super(Example,self).__init__()
        self.initUI()
​
    def initUI(self):
        hbox=QHBoxLayout()
        self.l1=QLabel("拖动滑动条去改变颜色")
        self.l1.setFont(QFont("Arial",16))
        hbox.addWidget(self.l1)
        self.s1=QScrollBar()
        self.s1.setMaximum(255)
        self.s1.sliderMoved.connect(self.sliderval)
        self.s2=QScrollBar()
        self.s2.setMaximum(255)
        self.s2.sliderMoved.connect(self.sliderval)
        self.s3=QScrollBar()
        self.s3.setMaximum(255)
        self.s3.sliderMoved.connect(self.sliderval)
        hbox.addWidget(self.s1)
        hbox.addWidget(self.s2)
        self.setGeometry(300,300,300,200)
        self.setWindowTitle("QScrollBar 例子")
        self.setLayout(hbox)
​
    def sliderval(self):
        print(self.s1.value(),self.s2.value(),self.s3.value())
        palette=QPalette()
        c=QColor(self.s1.value(),self.s2.value(),self.s2.value(),255)
        palette.setColor(QPalette.Foreground,c)
        self.l1.setPalette(palette)
​
if __name__ == '__main__':
    app=QApplication(sys.argv)
    demo=Example()
    demo.show()
    sys.exit(app.exec_())

运行效果
​

代码分析：
在这个例了中，设置了三个滑动条来控制标签中所显示文字的字体颜色的RGB
值。
当移动滑块时，将sliderMoved信号与槽函数sliderval()连接起来。

总结：高级控件的应用场景

PyQt5中的高级窗口控件为开发专业级GUI应用提供了强大支持：

• QDockWidget - 适用于需要灵活布局的开发环境（如IDE、图形设计软件）

• MDI界面 - 适合多文档处理应用（如文本编辑器、电子表格、CAD软件）

• QScrollBar - 不仅实现滚动功能，还可用于创建自定义控制面板（如调色板、参数调节器）

掌握这些控件的高级用法，能够显著提升应用的用户体验和专业感。建议在实际项目中根据具体需求组合使用这些控件，构建出既美观又高效的GUI界面。