Qt编程进阶(5):停靠窗口QDockWidget类的使用

停靠窗口QDockWidget类是应用程序中经常用到的，设置停靠窗口的一般流程如下：

• (1)创建一个QDockWidget对象的停靠窗体。
• (2)设置此停靠窗体的属性，通常调用setFeatures()及setAllowedAreas()两种方法。
• (3)新建一个要插入停靠窗体的控件，常用的有QListWidget和QTextEdit。
• (4)将控件插入停靠窗体，调用QDockWidget的setWidget()方法。
• (5)使用addDockWidget()方法在MainWindow中加入此停靠窗体。

本文实例演示停靠窗口QDockWidget类的使用，其功能如下：

• 窗口1可移动，只可在主窗口的左边和右边停靠；
• 窗口2不可移动，只可在浮动和右部停靠两种状态间切换；
• 窗口3不可移动，在左边显示垂直的标签栏。

运行效果如下图所示。

本实例是采用编写代码的方式实现的，具体步骤如下。

• (1)新建Qt Widgets Application，项目名称为“DockWindows”，基类选择“QMainWindow”，类名命名为“DockWindows”，取消“创建界面”复选框的选中状态。
• (2) 在“dockwindows.cpp”文件的开始部分加入以下头文件：

#include<QTextEdit>
#include<QDockWidget>

• (3) DockWindows类构造函数实现窗口的初始化及功能实现，具体代码如下：

DockWindows::DockWindows(QWidget *parent)
: QMainWindow(parent)
{
  setWindowTitle(tr("DockWindows"));//设置主窗口的标题栏文字
  QTextEdit *te=new QTextEdit(this); //定义一个QTextEdit对象作为主窗口
  te->setText(tr("Main Windows"));
  te->setAlignment(Qt::AlignCenter);
  setCentralWidget(te); //将此编辑框设为主窗口的中央窗体
  //停靠窗口 1
  QDockWidget *dock=new QDockWidget(tr("DockWindow1"), this);
  //可移动
  dock->setFeatures(QDockWidget::DockWidgetMovable); // (a)
  dock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea); // (b)
  QTextEdit *te1 =new QTextEdit();
  te1->setText(tr("窗口1可移动，只可在主窗口的左边和右边停靠"));
  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("窗口2不可移动，只可在浮动和右部停靠两种状态间切换"));
  dock->setWidget(te2);
  addDockWidget(Qt::RightDockWidgetArea,dock);
  //停靠窗口 3
  dock=new QDockWidget(tr("DockWindow3"), this);
  dock->setFeatures(QDockWidget::DockWidgetVerticalTitleBar); //带垂直标签栏
  QTextEdit *te3 =new QTextEdit();
  te3->setText(tr("窗口3不可移动，在左边显示垂直的标签栏"));
  dock->setWidget(te3);
  addDockWidget(Qt::RightDockWidgetArea,dock);
}

其中，

• (a) setFeatures()方法设置停靠窗体的特性，原型如下：

void setFeatures(DockWidgetFeatures features)

参数QDockWidget::DockWidgetFeatures指定停靠窗体的特性，包括以下几种参数。

• ① QDockWidget::DockWidgetClosable:停靠窗体可关闭。
• ② QDockWidget::DockWidgetMovable:停靠窗体可移动。
• ③ QDockWidget::DockWidgetFloatable:停靠窗体可浮动。
• ④ QDockWidget::AllDockWidgetFeatures:此参数表示拥有停靠窗体的所有特性。
• ⑤ QDockWidget::NoDockWidgetFeatures:不可移动、不可关闭、不可浮动。

此参数可釆用或(|)的方式对停靠窗体进行特性的设定。

• (b) setAllowedAreas()方法设置停靠窗体可停靠的区域，原型如下：

void setAllowedAreas(Qt::DockWidgetAreas areas)

参数QDockWidgetAreas指定了停靠窗体可停靠的区域，包括以下几种参数。

• ① Qt::LeftDockWidgetArea:可在主窗口的左侧停靠。
• ② Qt::RightDockWicfgetArea:可在主窗口的右侧停靠。
• ③ Qt::TopDockWidgetArea:可在主窗口的顶端停靠。
• ④ Qt::BottomDockWidgetArea:可在主窗口的底部停靠。
• ⑤ Qt::AllDockWidgetArea:可在主窗口任意（以上四个）部位停靠。
• ⑥ Qt::NoDockWidgetArea:只可停靠在插入处。

各区域设定也可采用或(|)的方式进行。

运行程序，初始显示如上图所示。鼠标拖动改变窗口1和窗口2的位置，显示如下图所示。

————————————————

觉得有用的话请关注点赞，谢谢您的支持！

对于本系列文章相关示例完整代码有需要的朋友，可关注并在评论区留言！