PyQt5 停靠窗口控件QDockWidget

Python的PyQt5库中的QDockWidget是一个停靠式窗口，可以在应用程序中创建一个可停靠到主窗口边缘的小窗口。下面详细讲解PyQt5的QDockWidget如何使用。

创建QDockWidget控件并设置

在使用QDockWidget之前，要先创建一个主窗口，并将QDockWidget添加到主窗口中。下面是创建QDockWidget并设置大小的代码示例：

from PyQt5.QtWidgets import QMainWindow, QTextEdit, QPushButton, QApplication, QDockWidget

class Example(QMainWindow):
    def __init__(self):
        super().__init__()

        self.initUI()

    def initUI(self):
        # 创建QTextEdit控件
        textEdit = QTextEdit()
        self.setCentralWidget(textEdit)

        # 创建QDockWidget控件，并添加到主窗口中
        dock = QDockWidget("Dockable", self)
        dock.setAllowedAreas(Qt.RightDockWidgetArea)
        button = QPushButton("Button", self)
        dock.setWidget(button)
        self.addDockWidget(Qt.RightDockWidgetArea, dock)

        self.setWindowTitle('QDockWidget')
        self.setGeometry(300, 300, 300, 200)

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

上面的示例代码中，我们创建了一个QTextEdit控件作为主窗口的中心组件，同时创建了一个QDockWidget控件，并将其添加到主窗口中的右侧。在QDockWidget中，我们添加了一个QPushButton控件，并使用setWidget()方法将其设置为QDockWidget的子控件。

其中，setAllowedAreas()方法可以设置QDockWidget在主窗口中允许停靠的区域，这里我们设置为Qt.RightDockWidgetArea表示可停靠在主窗口的右侧区域。addDockWidget()方法则将QDockWidget添加到主窗口的指定区域中。

停靠状态与浮动状态

在默认情况下，QDockWidget是停靠在主窗口上的。如果我们想让QDockWidget浮动出主窗口，只需将滑块拖到窗口边缘即可。

由于QDockWidget是一个可停靠的控件，我们可以通过QDockWidget的setFeatures()方法来设置其停靠状态。例如，下面的示例代码中，我们将QDockWidget的setFeatures()方法设置为QDockWidget.DockWidgetClosable，表示可关闭。

dock = QDockWidget("Dockable", self)
dock.setAllowedAreas(Qt.RightDockWidgetArea)
button = QPushButton("Button", self)
dock.setWidget(button)

dock.setFeatures(QDockWidget.DockWidgetClosable)

示例1：文本编辑器

下面的示例展示了如何使用QDockWidget创建一个简单的文本编辑器。

from PyQt5.QtWidgets import QMainWindow, QTextEdit, QApplication, QDockWidget
from PyQt5.QtCore import Qt
import sys

class Example(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        # 创建QTextEdit控件
        textEdit = QTextEdit()
        self.setCentralWidget(textEdit)

        # 创建QDockWidget控件，并添加到主窗口中
        dock = QDockWidget("Dockable", self)
        dock.setAllowedAreas(Qt.RightDockWidgetArea)
        button = QTextEdit()
        dock.setWidget(button)
        self.addDockWidget(Qt.RightDockWidgetArea, dock)

        self.setWindowTitle('Text Editor')
        self.setGeometry(300, 300, 300, 200)

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

上面的代码创建了一个文本编辑器，其中，我们使用QTextEdit作为主窗口的组件，使用QTextEdit作为QDockWidget的组件。

示例2：Excel表格

下面的示例展示了如何使用QDockWidget创建一个类似Excel表格的控件。

from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication, QMainWindow, QTableWidget, QTableWidgetItem, QDockWidget
import sys

class Example(QMainWindow):
    def __init__(self):
        super().__init__()
        self.initUI()

    def initUI(self):
        # 创建QTableWidget控件
        table = QTableWidget()
        table.setColumnCount(2)
        table.setRowCount(3)
        table.setHorizontalHeaderLabels(['Name', 'Value'])
        table.setItem(0, 0, QTableWidgetItem('A'))
        table.setItem(0, 1, QTableWidgetItem('1'))
        table.setItem(1, 0, QTableWidgetItem('B'))
        table.setItem(1, 1, QTableWidgetItem('2'))
        table.setItem(2, 0, QTableWidgetItem('C'))
        table.setItem(2, 1, QTableWidgetItem('3'))
        self.setCentralWidget(table)

        # 创建QDockWidget控件，并添加到主窗口中
        dock = QDockWidget("Dockable", self)
        dock.setAllowedAreas(Qt.RightDockWidgetArea)
        button = QTableWidget()
        button.setColumnCount(2)
        button.setRowCount(3)
        button.setHorizontalHeaderLabels(['Name', 'Value'])
        button.setItem(0, 0, QTableWidgetItem('D'))
        button.setItem(0, 1, QTableWidgetItem('4'))
        button.setItem(1, 0, QTableWidgetItem('E'))
        button.setItem(1, 1, QTableWidgetItem('5'))
        button.setItem(2, 0, QTableWidgetItem('F'))
        button.setItem(2, 1, QTableWidgetItem('6'))
        dock.setWidget(button)
        self.addDockWidget(Qt.RightDockWidgetArea, dock)

        self.setWindowTitle('Excel-like Table')
        self.setGeometry(300, 300, 400, 250)

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

上面的代码创建了一个类似Excel表格的控件，其中，我们使用QTableWidget作为主窗口的组件，使用QTableWidget作为QDockWidget的组件，并设置其水平表头、行数、列数、名称和条目。