六、停靠窗口 QDockWidget（Qt5 GUI系列）

---

目录

一、设计需求

二、实现代码

三、代码解析

四、总结

---

一、设计需求

        停靠窗口在应用程序中经常被使用。比如在Qt编辑界面、WPS编辑界面等设计软件的一些界面中有广泛的应用。本例需求窗口 1 只可在主窗口的左边和右边停靠；窗口 2 只可在浮动和右部停靠两种状态间切换，并且不可移动；窗口 3 可实现停靠窗口的各种状态。

二、实现代码

#include "dockwindows.h"
#include<QTextEdit>
#include<QDockWidget>

DockWindows::DockWindows(QWidget *parent)
    : QMainWindow(parent)
{
    setWindowTitle(tr("DockWindows"));	//设置主窗口的标题栏文字

    QTextEdit *te=new QTextEdit(this);	//定义一个QTextEdit对象作为主窗口
    te->setText(tr("Main Window"));
    te->setAlignment(Qt::AlignCenter);  //设置对齐方式，居中
    setCentralWidget(te);               //将此编辑框设为主窗口的中央窗体

    //停靠窗口1
    QDockWidget *dock=new QDockWidget(tr("DockWindow1"),this);
    dock->setFeatures(QDockWidget::DockWidgetMovable);                      //指定停靠窗体的特性，可移动
    dock->setAllowedAreas(Qt::LeftDockWidgetArea|Qt::RightDockWidgetArea);  //指定停靠窗体可停靠的区域，主窗口的左侧和右侧
    QTextEdit *te1 =new QTextEdit();
    te1->setText(tr("Window1,The dock widget can be moved between docks by the user" ""));//设置文本内容
    dock->setWidget(te1);
    addDockWidget(Qt::RightDockWidgetArea,dock);    //添加停靠窗体
    //停靠窗口2
    dock=new QDockWidget(tr("DockWindow2"),this);
    dock->setFeatures(QDockWidget::DockWidgetClosable|QDockWidget::DockWidgetFloatable); //可关闭、可浮动
    QTextEdit *te2 =new QTextEdit();
    te2->setText(tr("Window2,The dock widget can be detached from the main window,""and floated as an independent window, and can be closed"));
    dock->setWidget(te2);
    addDockWidget(Qt::RightDockWidgetArea,dock);
    //停靠窗口3
    dock=new QDockWidget(tr("DockWindow3"),this);
    dock->setFeatures(QDockWidget::AllDockWidgetFeatures);     //全部特性
    QTextEdit *te3 =new QTextEdit();
    te3->setText(tr("Window3,The dock widget can be closed, moved, and floated"));
    dock->setWidget(te3);
    addDockWidget(Qt::RightDockWidgetArea,dock);
}

DockWindows::~DockWindows()
{
    
}

效果展示：

三、代码解析

（1）setFeatures()

void setFeatures(DockWidgetFeatures features)

参数 QDockWidget::DockWidgetFeatures 指定停靠窗体的特性，包括以下几种参数。QDockWidget::DockWidgetClosable：停靠窗体可关闭。
QDockWidget::DockWidgetMovable：停靠窗体可移动。
QDockWidget::DockWidgetFloatable： 停靠窗体可浮动。
QDockWidget::AllDockWidgetFeatures:此参数表示拥有停靠窗体的所有特性。
QDockWidget: NoDockWidgetFeatures:不可移动、不可关闭、不可浮动。
此参数可采用或(|)的方式对停靠窗体进行特性的设定。

（2）setAllowedAreas()

void setAllowedAreas(Qt::DockWidgetAreas areas)

参数Qt::DockWidgetAreas 指定了停靠窗体可停靠的区域，包括以下几种参数。
Qt::LeftDockWidgetArea:可在主窗口的左侧停靠。
Qt::RightDockWidgetArea:可在主窗口的右侧停靠。
Qt::TopDockWidgetArea:可在主窗口的顶端停靠。
Qt::BottomDockWidgetArea:可在主窗口的底部停靠。
Qt::A11DockWidgetArea:可在主窗口任意(以上四个)部位停靠。
Qt::NoDockWidgetArea:只可停靠在插入处。
各区域设定也可采用或(|)的方式进行。

四、总结

        无论多复杂的界面都是简单的界面拼凑而成。