PyQt5 自定义标题栏在 PyQT5 中的应用

在本文中，我们将介绍如何在 PyQt5 中实现自定义标题栏并为其添加边框。自定义标题栏可以为我们的应用程序增添个性和美观，同时也可以提供额外的功能。

阅读更多：PyQt5 教程

PyQt5 简介

PyQt5 是一个用于创建跨平台桌面应用程序的Python库。它是对 Qt 库的封装，提供了与 Qt 库相同的功能和性能。PyQt5 支持多种操作系统，包括Windows、macOS和Linux。

如何创建自定义标题栏

在 PyQt5 中，我们可以使用 QFrame 来创建自定义标题栏。标题栏可以包含窗口标题、窗口图标、最小化、最大化按钮和关闭按钮等。

首先，我们需要导入 QFrame 和 QBoxLayout 类。然后，我们可以创建一个 QFrame 对象，并将其设置为窗口的标题栏。

from PyQt5.QtWidgets import *

class CustomTitleBar(QFrame):
    def __init__(self, parent):
        super().__init__(parent)
        self.setFixedHeight(40)
        self.layout = QHBoxLayout()
        self.layout.setContentsMargins(0, 0, 0, 0)
        self.setLayout(self.layout)

class MainWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("自定义标题栏")
        self.setWindowFlags(Qt.FramelessWindowHint)

        self.titleBar = CustomTitleBar(self)
        self.layout = QVBoxLayout()
        self.layout.addWidget(self.titleBar)
        self.setLayout(self.layout)

app = QApplication([])
window = MainWindow()
window.show()
app.exec()

在上述示例中，我们创建了一个 CustomTitleBar 类来定义自定义标题栏。我们将该自定义标题栏添加到 MainWindow 类中。

接下来，我们可以为标题栏添加所需的元素，如窗口标题、按钮和图标等。

class CustomTitleBar(QFrame):
    def __init__(self, parent):
        super().__init__(parent)
        self.setFixedHeight(40)
        self.layout = QHBoxLayout()
        self.layout.setContentsMargins(0, 0, 0, 0)
        self.setLayout(self.layout)

        self.title = QLabel("自定义标题栏")
        self.layout.addWidget(self.title)

        self.minimizeButton = QPushButton("-")
        self.layout.addWidget(self.minimizeButton)

        self.maximizeButton = QPushButton("口")
        self.layout.addWidget(self.maximizeButton)

        self.closeButton = QPushButton("x")
        self.layout.addWidget(self.closeButton)

在上述示例中，我们添加了一个 QLabel 对象来显示窗口标题，并添加了一个 QPushButton 对象来代表最小化、最大化和关闭按钮。

现在，我们已经创建了自定义标题栏，可以为其添加样式并为其添加边框。

class CustomTitleBar(QFrame):
    def __init__(self, parent):
        super().__init__(parent)
        self.setFixedHeight(40)
        self.layout = QHBoxLayout()
        self.layout.setContentsMargins(0, 0, 0, 0)
        self.setLayout(self.layout)

        self.title = QLabel("自定义标题栏")
        self.layout.addWidget(self.title)

        self.minimizeButton = QPushButton("-")
        self.layout.addWidget(self.minimizeButton)

        self.maximizeButton = QPushButton("口")
        self.layout.addWidget(self.maximizeButton)

        self.closeButton = QPushButton("x")
        self.layout.addWidget(self.closeButton)

        self.setStyleSheet("""
            QFrame {
                background-color: #333;
                border: 1px solid black;
                border-top-left-radius: 5px;
                border-top-right-radius: 5px;
            }

            QLabel {
                color: white;
                font-size: 16px;
                padding-left: 10px;
            }

            QPushButton {
                background-color: #333;
                color: white;
                border: none;
                font-size: 18px;
                width: 30px;
                height: 30px;
                border-radius: 15px;
            }

            QPushButton:hover {
                background-color: #666;
                cursor: pointer;
            }
        """)

在上述示例中，我们使用了 CSS 样式表为标题栏和按钮添加了样式。我们为 QFrame 设置了背景颜色和边框样式，并为 QLabel 设置了颜色、字体大小和左侧内边距。QPushButton 的样式包括背景颜色、颜色、边框样式、字体大小、宽度、高度和边界半径。同时，我们还为 QPushButton 添加了鼠标悬停时的样式效果。

通过以上步骤，我们已经成功创建了一个带有自定义边框的标题栏。

自定义标题栏的功能

除了外观的定制，我们还可以为自定义标题栏添加一些功能，例如拖动窗口、最小化、最大化和关闭窗口等。

拖动窗口

为了使自定义标题栏能够拖动窗口，我们需要在标题栏上实现鼠标事件的处理。具体步骤如下：

创建一个标志位 self.dragPos 来保存鼠标按下时的窗口坐标。
重写 mousePressEvent 方法，当标题栏被按下时，记录下鼠标的当前位置。
重写 mouseMoveEvent 方法，计算鼠标移动的距离，并通过 move 函数将窗口移动到新位置。

下面是示例代码：

class CustomTitleBar(QFrame):
    def __init__(self, parent):
        super().__init__(parent)
        # 省略其他代码

        self.dragPos = None

    def mousePressEvent(self, event):
        self.dragPos = event.globalPos()

    def mouseMoveEvent(self, event):
        if self.dragPos:
            self.parent().move(event.globalPos() - self.dragPos)
            event.accept()

    def mouseReleaseEvent(self, event):
        self.dragPos = None

通过上述代码，我们实现了标题栏的拖动功能。当鼠标按下标题栏时，记录下鼠标的位置。当鼠标移动时，根据新位置和之前保存的位置计算鼠标的移动距离，并通过 move 函数将窗口移动到新的位置。

最小化、最大化和关闭窗口

在标题栏的按钮上添加点击事件，可以实现最小化、最大化和关闭窗口的功能。

class CustomTitleBar(QFrame):
    def __init__(self, parent):
        super().__init__(parent)
        # 省略其他代码

        self.minimizeButton.clicked.connect(self.parent().showMinimized)
        self.maximizeButton.clicked.connect(self.toggleMaximize)
        self.closeButton.clicked.connect(self.parent().close)

    def toggleMaximize(self):
        if self.parent().isMaximized():
            self.parent().showNormal()
        else:
            self.parent().showMaximized()

在上述示例中，我们将最小化按钮绑定到 showMinimized 函数，将关闭按钮绑定到 close 函数。对于最大化按钮，我们创建了 toggleMaximize 函数来切换窗口的最大化状态。如果窗口当前已最大化，则将其还原为正常状态；如果窗口当前为正常状态，则将其最大化。

通过以上操作，我们已经成功添加了拖动窗口、最小化、最大化和关闭窗口的功能。