PyQt6自定义标题栏开发指南

1. 为什么需要自定义标题栏？

在PyQt6开发中，默认的窗口标题栏往往显得过于普通，无法满足现代GUI应用的美观需求。我最近为一个音乐播放器项目开发界面时，就遇到了这个痛点——系统自带的标题栏与整体设计风格格格不入。

原生标题栏主要有三个局限：

1. 样式固定，无法与应用程序主题完美融合
2. 功能按钮位置和样式受操作系统限制
3. 无法添加自定义控件（如迷你播放控制按钮）

通过完全自定义标题栏，我们可以：

• 实现与主界面统一的视觉风格
• 自由布局最小化/最大化/关闭按钮
• 添加额外功能区域（如搜索框、状态指示器）
• 创建无边框窗口的完整解决方案

2. 基础实现方案

2.1 窗口基本配置

首先需要创建一个无边框窗口作为基础：

python复制from PyQt6.QtWidgets import QApplication, QMainWindow

class CustomTitleBarWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowFlags(
            self.windowFlags() | 
            Qt.WindowType.FramelessWindowHint
        )
        self.setAttribute(Qt.WidgetAttribute.WA_TranslucentBackground)

关键点说明：

• FramelessWindowHint 移除系统边框
• WA_TranslucentBackground 启用透明背景（可选）
• 建议同时保留 Qt.WindowType.Window 标志

2.2 标题栏布局设计

典型的自定义标题栏应包含：

• 窗口图标
• 标题文本
• 窗口控制按钮（最小化/最大化/关闭）

python复制from PyQt6.QtWidgets import (
    QHBoxLayout, QLabel, 
    QPushButton, QWidget
)

class TitleBar(QWidget):
    def __init__(self, parent=None):
        super().__init__(parent)
        layout = QHBoxLayout(self)
        
        # 图标和标题
        self.icon = QLabel()
        self.title = QLabel("我的应用")
        
        # 控制按钮
        self.min_btn = QPushButton("－")
        self.max_btn