Python编程实例-PyQt5 GUI编程-可停靠窗口(QDockWidget)

可停靠窗口(QDockWidget)是一个子窗口，它可以保持浮动状态，也可以附加到主窗口的指定位置。 QMainWindow 类的主窗口对象有一个为QDockWidget保留的区域。 该区域位于中央小部件周围。

QDockWidget可以在主窗口内移动，也可以取消停靠以由用户移动到新区域。

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


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

        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 demo")


def main():
    app = QApplication(sys.argv)
    ex = MainWindow()
    ex.show()
    sys.exit(app.exec())


if __name__ == '__main__':
    main()

1）在例子中，顶层窗口是一个 QMainWindow 对象。 QTextEdit 对象是它的中心部件。

self.setCentralWidget(QTextEdit())

2）创建一个可停靠窗口(QDockWidget)：

self.items = QDockWidget("Dockable", self)

3）QListWidget 对象被添加到QDockWidget:

self.listWidget = QListWidget()
self.listWidget.addItem("item1")
self.listWidget.addItem("item2")
self.listWidget.addItem("item3")
self.items.setWidget(self.listWidget)

4）QDockWidget对象放置在中央小部件的右侧:

self.addDockWidget(Qt.RightDockWidgetArea, self.items)

运行结果：