目录

1.概述

2.常用函数介绍

3.QDockWidget布局相关

4.QDockWidget的使用注意事项

5.使用场景

6.简单应用示例代码

1.概述

2.常用函数介绍

QDockWidget dockWidget("标题", &mainWindow);

QWidget *customWidget = new QWidget;

dockWidget.setWidget(customWidget);

dockWidget.setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);

dockWidget.setFeatures(QDockWidget::DockWidgetClosable | QDockWidget::DockWidgetMovable);

dockWidget.setWindowTitle("My Dock Widget");

dockWidget.setVisible(true); // 显示停靠窗口

bool isFloating = dockWidget.isFloating();

dockWidget.close();

QAction *toggleAction = dockWidget.toggleViewAction();

toolBar->addAction(toggleAction);

QObject::connect(&dockWidget, &QDockWidget::topLevelChanged, [&](bool floating) {

if (floating) {

qDebug() << "窗口已浮动";

} else {

qDebug() << "窗口已停靠";

}

});

3.QDockWidget布局相关

• 停靠特性

• 停靠区域

① Qt::LeftDockWidgetArea：可在主窗口的左侧停靠。

② Qt::RightDockWidgetArea：可在主窗口的右侧停靠。

③ Qt::TopDockWidgetArea：可在主窗口的顶端停靠。

④ Qt::BottomDockWidgetArea：可在主窗口的底部停靠。

⑤ Qt::AllDockWidgetArea：可在主窗口任意（以上四个）部位停靠。

⑥ Qt::NoDockWidgetArea：只可停靠在插入处。

• 添加dock

• 分割dock

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

• dock tab化窗口

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

• 初始化大小

• 标题栏设置

QWidget *Widget = new QWidget;

ui->dockwidget_dockWidget_1->setTitleBarWidget(Widget);

• 标题栏竖起

4.QDockWidget的使用注意事项

5.使用场景

• 工具栏：将各种工具按钮、复选框、文本框等组合成一个可停靠的工具栏，方便用户使用。
• 属性窗口：显示选中对象的各种属性，如颜色、大小、边框、位置等，便于用户对其进行编辑。
• 输出窗口：显示应用程序的输出信息、错误信息、调试信息等，便于用户了解应用程序的运行状态。
• 工程浏览器：显示项目文件、文件夹、类、函数等信息的面板，方便用户导航和查找。
• 日志窗口：记录应用程序的操作日志、错误日志等信息，方便用户了解应用程序的运行情况和排查错误。

6.简单应用示例代码

#include "main_window.h"
#include <QDockWidget>
#include <QTextEdit>
MainWindow::MainWindow(QWidget *parent): QMainWindow(parent)
{this->setWindowTitle("停靠窗口");this->setFixedSize(600, 400);QTextEdit *pTextEdit = new QTextEdit(this);pTextEdit->setText("主窗口测试");pTextEdit->setAlignment(Qt::AlignLeft);this->setCentralWidget(pTextEdit);//停靠窗口实现QDockWidget *pDock = new QDockWidget("停靠窗口1", this);pDock->setFeatures(QDockWidget::DockWidgetMovable);pDock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);QTextEdit *pText1 = new QTextEdit(this);pText1->setText("你好");pDock->setWidget(pText1);this->addDockWidget(Qt::RightDockWidgetArea, pDock);
}