Qt中如何让QToolButton充满QDockWidget侧边栏？

这个问题我之前也碰到过～主要是QToolButton默认的布局间距、尺寸策略以及样式限制导致的，咱们通过几步调整就能实现你想要的效果：

问题原因分析 #

当设置setAutoRaise(true)后，QToolButton的悬停样式默认带有内边距，再加上QVBoxLayout默认的内容边距和间距，就导致按钮的悬停边框无法完全贴合侧边栏宽度。

具体解决方案 #

1. 清除布局的默认边距和间距 #

QVBoxLayout默认会保留一定的边距和间距，我们需要把这些设置为0，让按钮能完全填充布局空间：

dockVLayout->setContentsMargins(0, 0, 0, 0);
dockVLayout->setSpacing(0);

2. 设置QToolButton的尺寸策略 #

让按钮在水平方向自动拉伸，占满布局的可用宽度：

overviewBtn->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);

3. 自定义QToolButton的悬停样式 #

通过样式表调整按钮悬停状态下的背景和边框，确保铺满整个宽度：

overviewBtn->setStyleSheet(R"(
    QToolButton:hover {
        border: 1px solid #888;
        background-color: #E8F4F8;
        border-radius: 0px;
    }
    QToolButton {
        text-align: center;
        padding: 8px 0;
    }
)");

修改后的完整代码 #

sidebarDock = new QDockWidget(this);
addDockWidget(Qt::LeftDockWidgetArea, sidebarDock);

// 隐藏dock widget标题栏
QWidget *titleBarWidget = new QWidget(sidebarDock);
sidebarDock->setTitleBarWidget(titleBarWidget);
sidebarDock->titleBarWidget()->hide();

dockWidget = new QWidget(sidebarDock);
dockWidget->setObjectName("DockWidget");
dockWidget->setStyleSheet("#DockWidget { background-color: #F7DC6F; }");

dockVLayout = new QVBoxLayout(dockWidget);
// 清除布局边距和间距
dockVLayout->setContentsMargins(0, 0, 0, 0);
dockVLayout->setSpacing(0);

overviewBtn = new QToolButton(dockWidget);
overviewBtn->setAutoRaise(true);
overviewBtn->setIcon(QIcon(":/Icons/overview.png"));
overviewBtn->setText("Overview");
overviewBtn->setToolButtonStyle(Qt::ToolButtonTextUnderIcon);
// 设置尺寸策略让按钮水平拉伸
overviewBtn->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Fixed);
// 自定义悬停样式
overviewBtn->setStyleSheet(R"(
    QToolButton:hover {
        border: 1px solid #888;
        background-color: #E8F4F8;
        border-radius: 0px;
    }
    QToolButton {
        text-align: center;
        padding: 8px 0;
    }
)");

dockVLayout->addWidget(overviewBtn);
dockWidget->setLayout(dockVLayout);
sidebarDock->setWidget(dockWidget);

这样调整后，QToolButton的悬停边框就能完全贴合侧边栏宽度啦～如果需要更精细的样式调整，还可以根据需求修改样式表中的颜色、边框宽度等参数。

内容的提问来源于stack exchange，提问作者Theodore Tang