QT从零入门教程(六)：QDockWidget停靠窗口

QDockWidget

上节我们引出了QDockWidget的概念，这节进行讲解并加以引用。

常用函数：

1、addDockWidget：添加停靠控件，用于指定或更改停靠控件的位置以及方向。

void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget * dockwidget)
void QMainWindow::addDockWidget(Qt::DockWidgetArea area, QDockWidget * dockwidget, Qt::Orientation orientation)

2、splitDockWidget：分割窗口，用于对两个QDockWidget进行水平或垂直布局

void QMainWindow::splitDockWidget(QDockWidget * first, QDockWidget * second, Qt::Orientation orientation)

3、tabifyDockWidget：合并窗口，用于将多个QDockWidget叠加到同一区域。

void QMainWindow::tabifyDockWidget(QDockWidget * first, QDockWidget * second)

4、setDockNestingEnabled：是否允许嵌套布局

void QMainWindow::setDockNestingEnabled(bool enabled)

设置嵌套布局

在自编软件中，博主用到了9个QDockWidget，作为软件的基本窗口进行布局。下面介绍创建布局的方法。

首先是去除中央窗体（这是重点）。QMainWindow中自带中央窗体，如果不去除的话，可能会造成窗口间有空块的情况，大家可以自行尝试。去除后，所有窗口都由QDockWidget构成。

  // cpp
QWidget* p = takeCentralWidget();   //删除中央窗体
if (p)
    delete p;

setDockNestingEnabled(true);        //允许嵌套dock

创建多个窗口

首先对setFeatures函数内的参数进行解释。

dock->setFeatures(QDockWidget::DockWidgetMovable); // 设置可移动 
dock->setFeatures(QDockWidget::DockWidgetFloatable); // 设置可浮动 
dock->setFeatures(QDockWidget::DockWidgetClosable); // 设置可关闭 
dock->setFeatures(QDockWidget::AllDockWidgetFeatures); // 以上三种都包含

如果想对窗口大小进行限制呢？QDockWidget也有相应的函数。

dock ->setFixedWidth(int w);
dock ->setFixedHeight(int h);
dock ->setFixedSize(int w, int h);

dock ->setMinimumWidth(int minw);
dock ->setMinimumHeight(int minh);
dock ->setMinimumSize(int minw, int minh)

dock ->setMaximumWidth(int maxw);
dock ->setMaximumHeight (int maxh);
dock ->setMaximumSize(int maxw, int maxh)

实现代码：

// 头文件
QDockWidget *dock_Image;    // 图像窗口
QDockWidget* dock_Tool;// 工具箱窗口
QDockWidget* dock_Geom;// 几何变换窗口
QDockWidget* dock_Gray;// 灰度变换窗口
QDockWidget* dock_Enhance;// 图像增强窗口
QDockWidget* dock_Morp;// 形态学处理窗口
QDockWidget* dock_Color;// 颜色模型窗口
QDockWidget* dock_Prop;// 属性窗口
QDockWidget* dock_Output;// 输出窗口

// cpp
// QDockWidget* dock_Image = new QDockWidget(tr("图像"), this);               // 上节中已定义，如果只想做本节内容，可取消注释
dock_Image->setFeatures(QDockWidget::DockWidgetMovable | QDockWidget::DockWidgetFloatable);         // 设置为可移动可浮动，但不可关闭
dock_Image->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);  // 可移动范围：左右
dock_Image->setMinimumSize(600, 600);   // 设置最小宽高

dock_Tool = new QDockWidget(tr("工具箱"), this);           // 工具箱窗口,若想设置特征或移动范围，方法同上。
dock_Geom = new QDockWidget(tr("几何变换"), this);          // 几何变换窗口
dock_Gray = new QDockWidget(tr("灰度变换"), this);          // 灰度变换窗口
dock_Enhance = new QDockWidget(tr("图像增强"), this);       // 图像增强窗口
dock_Morp = new QDockWidget(tr("形态学处理"), this);     // 形态学处理窗口
dock_Color = new QDockWidget(tr("颜色模型"), this);         // 颜色模型窗口
dock_Prop = new QDockWidget(tr("属性"), this);                // 属性窗口
dock_Output = new QDockWidget(tr("输出"), this);          // 输出窗口

// 进行布局
setCentralWidget(dock_Image);       // 指定为中心窗口
addDockWidget(Qt::LeftDockWidgetArea, dock_Tool);
addDockWidget(Qt::BottomDockWidgetArea, dock_Output);
addDockWidget(Qt::RightDockWidgetArea, dock_Geom);
addDockWidget(Qt::RightDockWidgetArea, dock_Gray);
addDockWidget(Qt::RightDockWidgetArea, dock_Enhance);
addDockWidget(Qt::RightDockWidgetArea, dock_Morp);
addDockWidget(Qt::RightDockWidgetArea, dock_Color);
addDockWidget(Qt::RightDockWidgetArea, dock_Prop);

// 分割窗口
splitDockWidget(dock_Tool, dock_Image, Qt::Horizontal);     // 水平
splitDockWidget(dock_Geom, dock_Output, Qt::Vertical);      // 垂直

// 合并窗口
tabifyDockWidget(dock_Geom, dock_Gray);                     
tabifyDockWidget(dock_Gray, dock_Enhance);
tabifyDockWidget(dock_Enhance, dock_Morp);
tabifyDockWidget(dock_Morp, dock_Color);
tabifyDockWidget(dock_Output, dock_Prop);

dock_Geom->raise();             // raise()函数可使指定窗口置于最前

// connect(dock_Tool, SIGNAL(visibilityChanged(bool)), this, SLOT(isDockTool())); 
// 当窗体隐藏或显示时，其信号为visibilityChanged(bool)函数，此处仅作简单演示，槽函数是自定义的，其他窗口同理。

实现效果：