原文链接：https://blog.csdn.net/qq153471503/article/details/128528072
Demo下载：https://gitee.com/jhuangBTT/QtSideBar
1、简介
侧边栏是一个很常用的导航控件，如Qt Creator软件本身也使用到了侧边栏：
目前使用Qt做出这种侧边导航栏，常见的做法是使用QListWidget加QStackedWidget，但是使用QListWidget做侧边的这个导航很不灵活，想要复刻出和Qt Creator这个侧边栏同样的效果很费劲，所以本篇博客采用QToolButton加QStackedWidget形式，在用QSS进行美化以达到效果。
2、侧边栏控件组成
Qt Creator的侧边栏是图标加文字的形式，并且文字在图标下方，首先想到的就是QToolButton。
侧边栏默认背景颜色为灰色，选项按下后背景色变为浅灰色，且选项左侧有一个加粗显示：
当鼠标悬停在选项上时，背景变为深灰色：
以上效果可以通过QSS实现。
3、UI布局
界面拖入一个QWidget并将名称设置为sideBar，将三个QToolButton拖入sideBar中，并将sideBar设置为栅格布局，界面右侧拖入一个QStackedWidget，并将整体设置为栅格布局，布局结构如下：
注意：QStackedWidget控件拖入布局后，默认存在两个page，需要手动删除。
sideBar的styleSheet为：
QWidget{
background-color: rgb(228, 228, 228); /* 设置背景色为灰色 */
}
给QToolButton设置上图标、设置文字显示在图标下方、使能QToolButton的checked、使能互斥点击：
autoExclusive：当一个父类窗口下存在多个QToolButton时，如果autoExclusive设置为true，可以实现单选效果。
styleSheet设置如下：
/* 默认 */
QToolButton{
border-top: 3px outset transparent; /* 上边框宽度3像素、突出显示、颜色为透明 */
border-bottom: 7px outset transparent;
border-right: 3px outset transparent;
border-left: 3px outset transparent;
min-width: 80px; /* 控件最小宽度 */
min-height: 80px;
background-color: rgb(228, 228, 228);
}
/* 鼠标悬停 */
QToolButton:hover{
background-color: rgb(205, 205, 205);
}
/* 点击和按下 */
QToolButton:pressed,QToolButton:checked{
border-left: 3px outset rgb(93, 95, 97); /* 左边框宽度3像素、突出显示、颜色为深深灰 */
background-color: rgb(246, 246, 246);
}
QPushButton:default {
border-color: navy; /* make the default button prominent */
}
最后，将布局的边距都设为0：
创建三个UI界面，同样的操作，将布局整体进行栅格布局，并将边距设置为0：
4、代码实现界面的切换
到目前为止，其实大部分功能都已经完成了，只需要将QToolButton的checked信号和QStackedWidget的页面切换槽函数setCurrentIndex连接起来即可。
首先将需要显示的三个界面添加进QStackedWidget：
ui->stackedWidget->addWidget(&userWnd); // 此时userWnd界面的index为0
ui->stackedWidget->addWidget(&permissionWnd); // permissionWnd界面的index为1
ui->stackedWidget->addWidget(&settingsWnd); // settingsWnd界面的index为2
为了方便组织管理，可以将这三个QToolButton使用QButtonGroup进行管理，并给每个QToolButton设置一个ID，这个ID用来对应stackedWidget的页面index。注意QButtonGroup同样存在setExclusive方法，并且默认为true。
btnGroup.addButton(ui->btnUser, 0);
btnGroup.addButton(ui->btnPermission, 1);
btnGroup.addButton(ui->btnSettings, 2);
connect(&btnGroup, QOverload<int>::of(&QButtonGroup::buttonClicked), ui->stackedWidget, &QStackedWidget::setCurrentIndex);
最后再设置一下默认的显示界面：
// 设置默认选中的页面
btnGroup.button(0)->setChecked(true);
ui->stackedWidget->setCurrentIndex(0);
到此完成！
参考链接：
【C++/QT】QT实现侧边导航栏（附代码）
QT 实现自定义树状导航栏
qt实现侧边导航栏_UI设计干货分享：设计语言 - 侧边导航栏/分页文章来源：https://www.toymoban.com/news/detail-426635.html
Qt 性能优化：CPU占有率高的现象和解决办法文章来源地址https://www.toymoban.com/news/detail-426635.html
到了这里，关于使用QToolButton和QStackedWidget的侧边栏（SideBar）的实现与实现原理解析的文章就介绍完了。如果您还想了解更多内容，请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章，希望大家以后多多支持TOY模板网！
