PyQt5 QDockWidget – 设置标题栏小部件

下面是关于PyQt5 QDockWidget设置标题栏小部件的完整使用攻略：

概述

QDockWidget是PyQt5中的一个窗口小部件，通常用于实现可在主窗口中停靠、可移动和可关闭的浮动部件。在默认情况下，QDockWidget会在标题栏中显示”浮动“、”关闭"等标准按钮，但是我们也可以添加自定义的小部件到标题栏中。

Qt Designer工具

首先我们需要使用Qt Designer工具定义标题栏中的小部件。具体方法是在QWidget中添加QLabel控件，然后放置我们需要的标题文字。最终效果就是在标题栏左侧显示自定义的文字。

Python代码

接下来我们需要通过代码实现将自定义小部件加入到QDockWidget的标题栏中。具体步骤如下：

首先，我们需要导入PyQt5中的QDockWidget及其他相关的模块：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QDockWidget, QWidget, QLabel

然后，我们定义一个QMainWindow并在其中创建一个QDockWidget：

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

    def initUI(self):
        dock = QDockWidget("Dock Widget", self)
        self.addDockWidget(1, dock)

在创建完QDockWidget之后，我们需要获取其标题栏 QWidget 对象：

titleBar = dock.titleBarWidget()

接着，我们可以创建我们在Qt Designer工具中定义的QLabel对象：

label = QLabel("My Custom Title")

接下来，我们将QLabel对象放置到标题栏QWidget中，然后设置其位置：

titleBarLayout = titleBar.layout()
titleBarLayout.addWidget(label, 0, 0)

其中，第二个参数是行，第三个参数是列。在示例代码中，我们将QLabel放置在标题栏最左侧，因此这里的行和列都是0。

完整示例代码如下：

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QDockWidget, QWidget, QLabel

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

    def initUI(self):
        dock = QDockWidget("Dock Widget", self)
        self.addDockWidget(1, dock)

        titleBar = dock.titleBarWidget()
        label = QLabel("My Custom Title")
        titleBarLayout = titleBar.layout()
        titleBarLayout.addWidget(label, 0, 0)

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

示例解析

下面，我们来看两个实际的示例，以说明如何使用QDockWidget和标题栏小部件。

示例1：设置带有自定义标题栏的QDockWidget

在这个示例中，我们将创建一个QDockWidget，并给它设置一个自定义的标题栏。在这个标题栏中，我们会添加一个包含标题和按钮的QWidget，并将这个QWidget放置在标题栏的中心位置。

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication, QMainWindow, QAction, QDockWidget, QWidget, QLabel, QPushButton, QHBoxLayout, QVBoxLayout

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

    def initUI(self):
        # Create a dockable widget
        dockable_widget = QDockWidget("Dock Widget", self)
        self.addDockWidget(Qt.LeftDockWidgetArea, dockable_widget)

        # Create a central widget with a label and a button
        central_widget = QWidget(self)
        central_widget_layout = QHBoxLayout()
        central_widget.setLayout(central_widget_layout)

        label = QLabel("My Custom Title")
        central_widget_layout.addWidget(label, Qt.AlignVCenter)

        button = QPushButton("Close")
        central_widget_layout.addWidget(button, Qt.AlignVCenter)

        # Add central widget to the title bar of the dockable widget
        title_bar_widget = QWidget(dockable_widget)
        title_bar_layout = QHBoxLayout()
        title_bar_layout.addWidget(central_widget, Qt.AlignCenter)
        title_bar_widget.setLayout(title_bar_layout)
        dockable_widget.setTitleBarWidget(title_bar_widget)

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

运行上面的代码，会在左侧生成一个QDockWidget，并在标题栏中显示一个包含标题和关闭按钮的QWidget。当单击关闭按钮时，QDockWidget会自动隐藏。

示例2：将自定义QLabel添加到标题栏中

在这个示例中，我们将创建一个QDockWidget，并将自定义的QLabel添加到其标题栏中。

import sys
from PyQt5.QtCore import Qt
from PyQt5.QtWidgets import QApplication, QMainWindow, QAction, QDockWidget, QWidget, QLabel

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

    def initUI(self):
        # Create a dockable widget
        dockable_widget = QDockWidget("Dock Widget", self)
        self.addDockWidget(Qt.LeftDockWidgetArea, dockable_widget)

        # Add a custom label to the title bar of the dockable widget
        title_bar = dockable_widget.titleBarWidget()
        label = QLabel("My Custom Title", title_bar)
        title_bar.setObjectName("MyTitleBar")
        label.setObjectName("MyTitleLabel")
        label.setAlignment(Qt.AlignCenter)
        title_bar.setStyleSheet("QWidget#MyTitleBar { background-color: #333 } QLabel#MyTitleLabel { color: #fff }")

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

在这个示例中，我们通过CSS样式表将标题栏的背景颜色设置为灰色，并将QLabel的颜色设置为白色。运行这个示例，会在左侧生成一个QDockWidget，并在其标题栏中显示自定义的QLabel。