QT中QDockWidget使用详解
Qt系列文章目录
文章目录
- Qt系列文章目录
- 前言
- 一、具体操作
-
- 1.QDockWidget控件配置函数
- 2.代码
-
- 1 .头文件
- 2.实现文件
- 效果
- 遇到的问题
前言
QDockWidget提供了dock widget的概念，也称为工具面板或实用工具窗口。停靠窗口是放置在QMainWindow中央小部件周围的停靠小部件区域中的次要窗口。许多工程软件，如Qt Creator，VS，matlab等，都是使用dock布局窗口，这样用户可以自定义界面，自由组合窗口。
Qt的嵌套布局由QDockWidget完成，用Qt Creator拖界面得到的dock布置形式比较固定，不能得想要的任意组合形式，要得到如下图所示的效果，后续布局必须通过代码来完成。
如图所示：
一、具体操作
1.新建QMainWindow基类工程，在ui设计页面拖入3个QDockWidget控件。
也可以不在UI设计器里面加，使用代码加入QDockWidget控件
2.因为整个窗口都由dock组成，所以在myMainWindow的构造函数中先把QMainWindow的中间窗口部件去除。
QWidget* central_form = takeCentralWidget();
if(central_form)
delete central_form;
3.用setWindowTitle(const QString &)函数为每个dock添加标题便于后面区分。
this->setWindowTitle(tr("图像处理系统"));
4.接下来配置DockWidget嵌套
setDockNestingEnabled(true);
这句语句是用来配置dock是否可以嵌套。通过查询帮助文档，我们可以知道，如果参数为false，则停靠区域只能水平或者垂直，即dock不能放置在中间，只能在两侧排布。如果参数为true，那么dock所占用的区域可以向任意方向排布。
接下来先移除所有的dock，我们来调整dock位置。调整dock位置前通过
void MainFramework::dockLayout() {
this->addDockWidget(Qt::LeftDockWidgetArea, m_projManagerView, Qt::Orientation::Vertical);
this->addDockWidget(Qt::RightDockWidgetArea, m_propertyView, Qt::Orientation::Vertical);
this->addDockWidget(Qt::BottomDockWidgetArea, m_logView, Qt::Orientation::Vertical);
}
5.为第一个dock指定位置，接下来通过配置的参数对所有的dock进行排列，这个函数是将第一个停靠dock覆盖的空间分成两部分，将第一个停靠dock移动到第一部分中，并将第二个停靠dock移动到第二部分中。通过这样的方式可以先左右，再上下的原则依次对dock进行排列。例如：
void QMainWindow::splitDockWidget(QDockWidget *first, QDockWidget *second, Qt::Orientation orientation)
1.QDockWidget控件配置函数
1.配置dock最小的宽度、高度，最大尺寸。
m_logView->setMinimumWidth(150);
m_propertyView->setMinimumHeight(100);
m_projManagerView->setMaximumSize(100,100);
2.隐藏标题栏。
QWidget* TitleBar = m_propertyView->titleBarWidget();
QWidget* EmptyWidget = new QWidget();
m_propertyView->setTitleBarWidget(EmptyWidget);
delete TitleBar;
3.合并窗口，采用void QMainWindow::tabifyDockWidget(QDockWidget *first, QDockWidget *second)函数，将多个QDockWidget叠加到同一区域。
tabifyDockWidget(ui->dockWidget_4,ui->dockWidget_5);
m_propertyView->setFeatures(QDockWidget::DockWidgetFloatable);
效果如下：
- -通过 void setFeatures(DockWidgetFeatures features)配置dock是否可关闭、漂浮、拖动等属性，它的参数有：
2.代码
1 .头文件
#ifndef MAINFRAMEWORK_H
#define MAINFRAMEWORK_H
#include 2.实现文件
#include "MainFramework.h"
#include "ui_MainFramework.h"
#include 效果
源码下载
遇到的问题
上图是运行效果图，左边的树形视图少了一道分割竖线，看起来很纠结，解决办法：在左边的QDockWidget界面设计器中加入：
0
0
3
1
1
-
QTabWidget:pane {border-left:1px solid #a0a0a0; border-right:1px solid #a0a0a0;}
QTabBar::tab{min-height: 28px; min-width:80px ; font:14px; }
QTabBar::tab:!selected{}
QTabBar::tab:!selected:hover{ background-color: #d9fffe; color: black;}
"tabShape">
QTabWidget::Triangular
"currentIndex">
-1
"6" margin="11"/>
