Mac平台Qt主窗口：如何使QDockWidget标题栏与QToolbar高度一致？

嘿，这个问题我在Mac上做Qt开发时也踩过坑！默认情况下，QDockWidget的标题栏是系统原生绘制的，而QToolbar的高度由Qt自身控制，确实容易出现高度不匹配的情况。下面给你几个实用的解决思路：

方法一：用Qt样式表（QSS）强制统一高度 #

这是最简单直接的方式，通过设置QToolBar和QDockWidget标题栏的固定高度来对齐。你可以在主窗口初始化代码里或者单独的样式表文件中添加以下规则：

/* 统一QToolbar的高度 */
QToolBar {
    min-height: 32px; /* 这里设置你想要的高度，比如和Mac原生工具栏对齐的32px */
    max-height: 32px;
    padding: 0 4px; /* 保持内边距和QDock标题栏一致，让视觉更协调 */
}

/* 设置QDockWidget标题栏的高度 */
QDockWidget::title {
    height: 32px;
    padding: 0 8px; /* 微调内边距，让标题文字位置和Toolbar对齐 */
    background-color: #f0f0f0; /* 可选：匹配Toolbar的背景色，增强统一性 */
}

注意：Mac上原生QDock标题栏自带默认内边距和阴影，你可能需要多次微调padding值，让两者的视觉对齐更自然。如果QSS规则不生效，记得检查是否有其他样式代码覆盖了当前设置。

方法二：自定义QDockWidget的标题栏 #

如果QSS无法满足精细的样式需求（比如想要完全复刻QToolbar的按钮、阴影效果），可以自己实现一个标题栏部件，完全控制其高度和外观：

// 自定义标题栏类
class DockTitleBar : public QWidget {
public:
    explicit DockTitleBar(QWidget* parent = nullptr) : QWidget(parent) {
        // 设置和QToolbar完全一致的高度
        setFixedHeight(32);
        
        // 布局标题和操作按钮
        QHBoxLayout* layout = new QHBoxLayout(this);
        layout->setContentsMargins(8, 0, 8, 0);
        layout->setSpacing(4);
        
        // 标题标签
        QLabel* titleLabel = new QLabel(this);
        titleLabel->setText("我的停靠部件");
        titleLabel->setAlignment(Qt::AlignVCenter);
        layout->addWidget(titleLabel);
        
        // 拉伸空白区域，把按钮挤到右侧
        layout->addStretch();
        
        // 关闭按钮（模仿Mac原生样式）
        QPushButton* closeBtn = new QPushButton(this);
        closeBtn->setIcon(QIcon::fromTheme("window-close"));
        closeBtn->setFixedSize(20, 20);
        closeBtn->setStyleSheet("border: none; background: transparent;");
        layout->addWidget(closeBtn);
        
        // 关联关闭按钮信号
        connect(closeBtn, &QPushButton::clicked, [this]() {
            if (auto dock = qobject_cast<QDockWidget*>(parentWidget())) {
                dock->close();
            }
        });
    }
};

// 在主窗口中使用自定义标题栏
QDockWidget* dockWidget = new QDockWidget(this);
dockWidget->setTitleBarWidget(new DockTitleBar(dockWidget));

这个方法的优势是你可以完全自定义标题栏的细节，比如按钮样式、背景渐变、 hover 效果等，完美和QToolbar对齐。不过要注意：自定义标题栏后，QDockWidget的拖拽浮动功能需要自己实现（如果需要的话），或者可以保留原生的拖拽逻辑。

方法三：禁用原生控件样式（谨慎使用） #

如果上面两种方法都不生效，可以尝试禁用Qt的原生控件样式，让QDockWidget和QToolbar都使用Qt的通用样式：

// 在main函数开头添加这行代码
QApplication::setAttribute(Qt::AA_DontUseNativeWidgetStyles);

注意：这个方法会改变整个应用的样式，所有原生控件都会变成Qt的默认风格，可能和Mac的系统视觉冲突，所以只在万不得已时使用。

内容的提问来源于stack exchange，提问作者P. Preet