Qt中QDockWidget的使用方式

在PyQt5中使用QDockWidget可以创建灵活的停靠窗口，增强应用程序的多功能性。以下是详细的步骤和示例代码：

基本步骤

导入模块：确保导入必要的PyQt5模块。
创建主窗口：继承QMainWindow并初始化界面。
设置中心部件：例如QTextEdit作为主内容区域。
创建QDockWidget：
- 设置标题、允许停靠的区域和特性（可关闭、可移动等）。
- 添加内容部件（如QListWidget）。
添加停靠窗口：使用addDockWidget()将QDockWidget添加到主窗口。
处理多个停靠窗口：使用splitDockWidget()或tabifyDockWidget()进行布局管理。

示例代码

import sys
from PyQt5.QtWidgets import (QApplication, QMainWindow, QTextEdit, QDockWidget, QListWidget)
from PyQt5.QtCore import Qtclass MainWindow(QMainWindow):def __init__(self):super().__init__()self.initUI()def initUI(self):# 设置中心文本编辑器self.textEdit = QTextEdit()self.setCentralWidget(self.textEdit)# 创建左侧停靠窗口dockLeft = QDockWidget("工具面板", self)dockLeft.setAllowedAreas(Qt.LeftDockWidgetArea | Qt.RightDockWidgetArea)dockLeft.setFeatures(QDockWidget.DockWidgetClosable | QDockWidget.DockWidgetMovable)# 添加列表内容listWidget = QListWidget()listWidget.addItems(["工具1", "工具2", "工具3"])dockLeft.setWidget(listWidget)self.addDockWidget(Qt.LeftDockWidgetArea, dockLeft)# 创建右侧停靠窗口dockRight = QDockWidget("属性面板", self)dockRight.setAllowedAreas(Qt.RightDockWidgetArea)dockRight.setFeatures(QDockWidget.DockWidgetFloatable | QDockWidget.DockWidgetClosable)# 添加属性列表propList = QListWidget()propList.addItems(["大小", "颜色", "位置"])dockRight.setWidget(propList)self.addDockWidget(Qt.RightDockWidgetArea, dockRight)# 设置窗口属性self.setWindowTitle('停靠窗口示例')self.setGeometry(100, 100, 1000, 600)if __name__ == '__main__':app = QApplication(sys.argv)mainWin = MainWindow()mainWin.show()sys.exit(app.exec_())

关键方法说明

setAllowedAreas()：指定允许停靠的区域（使用Qt.DockWidgetArea枚举值，如Qt.LeftDockWidgetArea）。
setFeatures()：设置停靠窗口特性，如QDockWidget.DockWidgetClosable（可关闭）、QDockWidget.DockWidgetMovable（可移动）。
addDockWidget()：将停靠窗口添加到主窗口的指定区域。
splitDockWidget(existing, new, orientation)：分割现有停靠区域来放置新窗口。
tabifyDockWidget(first, second)：将两个停靠窗口堆叠为标签页形式。