用 Qt 给 QDialog 手写一个可拖拽的标题栏

拖动逻辑就靠三个事件：按下时记录鼠标在屏幕上的绝对位置，移动时算出窗口新坐标并挪过去，松开时重置标记。注意 titleBar->rect().contains(event->pos()) 是为了只在点击标题栏区域时触发拖动，点对话框其他地方不会误拖。

标题栏本身用一个 QWidget 加 QHBoxLayout，左边放标题，右边塞按钮。addStretch() 把按钮挤到最右，这个技巧在各种自定义 Widget 里都很常用。

按钮功能直接用 lambda 或槽函数实现，最大化时切换显示尺寸，最小化和关闭也是现成的接口。

样式和字号

系统标题栏的字号没法改，但自己写的就随你了。直接给 titleLabel 设个 QFont 或者写 QSS 都行：

QFont font;
font.setPointSize(14);
titleLabel->setFont(font);

或者用样式表：

titleBar->setStyleSheet("QLabel { font-size: 16px; color: #2c3e50; }");

上面 C++ 示例里用的是 12px 加粗，可以根据项目整体风格调整。深色标题栏加白色文字是常用的暗色主题搭配，悬停变亮也是常规操作。

跨平台适配

不同平台标题栏行为差异不小：

• Windows：标准标题栏高度约 30px，窗口控件在右，Aero 效果对自定义无影响。
• macOS：高度只有 22px 左右，交通灯按钮在左，全屏模式需要额外处理。
• Linux：完全看桌面环境，KDE 和 GNOME 的标题栏高度、圆角半径都不一样。

用条件编译可以分开处理：

#ifdef Q_OS_WIN
    // Windows 特定样式或行为
#endif
#ifdef Q_OS_MAC
    NSWindow *window = reinterpret_cast<NSWindow *>(winId());
    [window setTitlebarAppearsTransparent:YES];
#endif

实际项目里，我通常会抽一个 TitleBar 类，在构造函数里根据平台宏设置默认高度和按钮顺序，免得主窗口代码膨胀。

Python (PySide6) 实现

如果团队用 Python 开发，逻辑完全一样，只是语法不同：

import sys
from PySide6.QtWidgets import (
    QApplication, QDialog, QLabel, QPushButton, QHBoxLayout, QVBoxLayout, QWidget
)
from PySide6.QtCore import Qt, QPoint

class CustomDialog(QDialog):
    def __init__(self, parent=None):
        super().__init__(parent)
        # 隐藏系统标题栏
        self.setWindowFlags(self.windowFlags() | Qt.FramelessWindowHint)
        self.setAttribute(Qt.WA_TranslucentBackground)
        self.setFixedSize(400, 300)
        # 创建自定义标题栏
        self.title_bar = self.create_title_bar()
        # 主内容区域
        content_widget = QWidget(self)
        main_layout = QVBoxLayout(self)
        main_layout.addWidget(self.title_bar)
        main_layout.addWidget(content_widget)
        # 添加示例内容
        content_label = QLabel("这是自定义对话框的内容区域", content_widget)
        content_label.setAlignment(Qt.AlignCenter)
        # 窗口拖动支持
        self.m_drag_position = QPoint()

    def create_title_bar(self):
        """创建自定义标题栏"""
        title_bar = QWidget(self)
        title_bar.setFixedHeight(40)
        title_bar.setObjectName("titleBar")
        # 布局
        title_layout = QHBoxLayout(title_bar)
        title_layout.setContentsMargins(10, 0, 10, 0)
        # 标题标签
        title_label = QLabel("自定义对话框", title_bar)
        title_label.setStyleSheet("font-size: 14px; color: white;")
        # 功能按钮
        min_btn = QPushButton("-", title_bar)
        max_btn = QPushButton("□", title_bar)
        close_btn = QPushButton("×", title_bar)
        min_btn.setFixedSize(30, 30)
        max_btn.setFixedSize(30, 30)
        close_btn.setFixedSize(30, 30)
        # 按钮样式
        for btn in [min_btn, max_btn, close_btn]:
            btn.setStyleSheet("""
                QPushButton { background-color: transparent; color: white; border: none; font-weight: bold; }
                QPushButton:hover { background-color: #34495e; }
            """)
        # 布局组装
        title_layout.addWidget(title_label)
        title_layout.addStretch()
        title_layout.addWidget(min_btn)
        title_layout.addWidget(max_btn)
        title_layout.addWidget(close_btn)
        # 标题栏样式
        title_bar.setStyleSheet("""
            #titleBar { background-color: #2c3e50; border-top-left-radius: 5px; border-top-right-radius: 5px; }
        """)
        # 信号连接
        min_btn.clicked.connect(self.showMinimized)
        max_btn.clicked.connect(self.toggle_maximize)
        close_btn.clicked.connect(self.reject)
        return title_bar

    def mousePressEvent(self, event):
        """处理鼠标按下事件（实现窗口拖动）"""
        if event.button() == Qt.LeftButton and not self.isMaximized():
            self.m_drag_position = event.globalPosition().toPoint() - self.frameGeometry().topLeft()
            super().mousePressEvent(event)

    def mouseMoveEvent(self, event):
        """处理鼠标移动事件（实现窗口拖动）"""
        if event.buttons() & Qt.LeftButton and not self.isMaximized():
            self.move(event.globalPosition().toPoint() - self.m_drag_position)
            super().mouseMoveEvent(event)

    def toggle_maximize(self):
        """切换窗口最大化状态"""
        if self.isMaximized():
            self.showNormal()
        else:
            self.showMaximized()

if __name__ == "__main__":
    app = QApplication(sys.argv)
    dialog = CustomDialog()
    dialog.show()
    sys.exit(app.exec())

Python 版本多了 WA_TranslucentBackground 属性，方便实现透明或圆角效果。拖动里用了 frameGeometry().topLeft() 计算偏移，和 C++ 的 globalPosition() - mousePressPosition 本质上一样，只是写法差异。

几个实用的扩展

上面的代码只是基础骨架，实际产品里经常会加点料：

1. 窗口缩放：在对话框四角放几个透明的小 QWidget，重写 mouseMoveEvent 处理 resize，体验会好很多。
2. 状态保存：关闭时把 geometry 存到 QSettings，下次打开自动恢复位置大小：

void closeEvent(QCloseEvent *event) {
    QSettings settings("MyApp", "CustomDialog");
    settings.setValue("geometry", saveGeometry());
    QDialog::closeEvent(event);
}

3. 标题栏图标：加个 QLabel 放 pixmap，和标题并排，让窗口辨识度更高。
4. 阴影效果：用 QGraphicsDropShadowEffect 给 titleBar 加个半透明阴影，立体感立刻上去：

QGraphicsDropShadowEffect *shadow = new QGraphicsDropShadowEffect(this);
shadow->setBlurRadius(15);
shadow->setColor(QColor(0, 0, 0, 100));
titleBar->setGraphicsEffect(shadow);

这些都不是必须的，但加一两个能让 UI 从'能用'变成'好看'。

根据项目语言选 C++ 或 PySide6 的实现，跨平台再用条件编译微调，大部分场景就够用了。