Qt:DockWidget自动停靠窗口，自定义标题栏，自由布局

已于 2024-10-21 14:59:53 修改
阅读量1.2k 收藏 10
点赞数 2
分类专栏： DockWidget 文章标签： qt 开发语言
于 2023-03-22 20:50:28 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/dy2017/article/details/129718740
版权
该文介绍了一个使用Qt实现的替代QDockWidget的方案，支持自定义标题栏、窗口隐藏和停靠功能，适用于Windows和Linux平台，且兼容Qt5.12.10和Qt6.0以上版本。代码示例展示了如何创建和管理多个可停靠、浮动的QTextEdit部件，同时提供了QSS控制样式的方法。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

@Qt实现自动停靠窗口 替代QDockWidget，自定义标题栏，可隐藏，可停靠

  1. 可支持windows和linux平台，资源下载只提供了windows版本
  2. 支持Qt5.12.10，支持Qt6.0以上版本，更低版本未测试编译
  3. MinGW7.3.0编译
  4. 浮动时拖动停靠功能未实现，觉得没啥用
  5. 双击标题栏，浮动窗口，Tabbed状态时，双击标签浮动窗口，双击标题栏还原
  6. QSS控制样式，可在测试程序中截获QSS代码，自行改变风格。
  7. 可用于QDialog或QWidget中
  8. 不可用于商业软件。
  9. 有可能开源。

MainWindow.h

#include <QMainWindow>
#include "DockManager.h"
#include "DockTheme.h"

class TestWidget :public QWidget
{
    Q_OBJECT
public:
    TestWidget(QWidget *parent = nullptr):QWidget(parent){};

public:
    virtual void resizeEvent(QResizeEvent *event);
};

QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();
    
    void test3();
    void test4();

private slots:
    void on_actionTest1_triggered();
    void on_actionTest2_triggered();
    void on_actionTest3_triggered();

protected:
    void updateTheme();

private:
    Ui::MainWindow *ui;

    DockManager *dockManager;
    DockWidget *dock1;
    DockWidget *dock2;
    DockWidget *dock3;
    DockWidget *dock4;
    DockWidget *dock5;
    DockWidget *dock6;
    DockWidget *dock7;
    DockWidget *dock8;
    DockWidget *dock9;
    DockWidget *dock10;
    DockWidget *dock11;
    DockWidget *dock12;
    DockWidget *dockFloat;

    DockTheme m_dockTheme;
};

MainWindow.cpp

#include "ui_MainWindow.h"
#include "DockManager.h"

#include <QFile>
#include <QDir>
#include <QTextEdit>
#include <QDebug>

#include <QMdiArea>
#include <QLayout>

#include <QToolBar>
#include <QCheckBox>
#include <QResizeEvent>


void TestWidget::resizeEvent(QResizeEvent *event)
{
    //测试dock时，centralWidget是否resize
    qDebug() << "TestWidget::resizeEvent" << event->size() << event->oldSize() << this->size();
    QWidget::resizeEvent(event);
}

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
    , dockManager(new DockManager)
{

    ui->setupUi(this);
    setAttribute(Qt::WA_StyledBackground, true);
    updateTheme();

    setCentralWidget(dockManager->widget());
    //dockManager->setCentralWidget(new QMdiArea);
    //dockManager->setCentralWidget(new QTextEdit);
    dockManager->setCentralWidget(new TestWidget);

    dockFloat = dockManager->createDock(QIcon(":/image/res/palette.png"),"dockFloat",dockNone);
    dockFloat->setWidget(new QTextEdit("dockFloat"));
    //dockFloat->setFloat(this);
    dockFloat->setFloat(dockManager->widget());

    //测试1
//    test1();
//    测试2
//    test2();
//    //测试3
//    test3();
//    //测试4
    test4();

    QToolBar *toolBar = new QToolBar;
    addToolBar(Qt::TopToolBarArea,toolBar);
    toolBar->setMovable(false);

    QCheckBox * ckb_dock1 = new QCheckBox("Dock1");
    toolBar->addWidget(ckb_dock1);
    ckb_dock1->setChecked(dock1->isVisible());
    connect(ckb_dock1, &QCheckBox::clicked, this,[=](bool checked) {
        dock1->setVisible(checked);
    });
    connect(dock1,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock1->isChecked()==isVisible) return;
        ckb_dock1->setChecked(isVisible);
    });

    QCheckBox * ckb_dock2 = new QCheckBox("Dock2");
    toolBar->addWidget(ckb_dock2);
    ckb_dock2->setChecked(dock2->isVisible());
    connect(ckb_dock2, &QCheckBox::clicked, this,[=](bool checked) {
        dock2->setVisible(checked);
    });
    connect(dock2,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock2->isChecked()==isVisible) return;
        ckb_dock2->setChecked(isVisible);
    });

    QCheckBox * ckb_dock3 = new QCheckBox("Dock3");
    toolBar->addWidget(ckb_dock3);
    ckb_dock3->setChecked(dock3->isVisible());
    connect(ckb_dock3, &QCheckBox::clicked, this,[=](bool checked) {
        dock3->setVisible(checked);
    });
    connect(dock3,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock3->isChecked()==isVisible) return;
        ckb_dock3->setChecked(isVisible);
    });

    QCheckBox * ckb_dock4 = new QCheckBox("Dock4");
    toolBar->addWidget(ckb_dock4);
    ckb_dock4->setChecked(dock4->isVisible());
    connect(ckb_dock4, &QCheckBox::clicked, this,[=](bool checked) {
        dock4->setVisible(checked);
    });
    connect(dock4,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock4->isChecked()==isVisible) return;
        ckb_dock4->setChecked(isVisible);
    });

    QCheckBox * ckb_dock5 = new QCheckBox("Dock5");
    toolBar->addWidget(ckb_dock5);
    ckb_dock5->setChecked(dock5->isVisible());
    connect(ckb_dock5, &QCheckBox::clicked, this,[=](bool checked) {
        dock5->setVisible(checked);
    });
    connect(dock5,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock5->isChecked()==isVisible) return;
        ckb_dock5->setChecked(isVisible);
    });

    QCheckBox * ckb_dock6 = new QCheckBox("Dock6");
    toolBar->addWidget(ckb_dock6);
    ckb_dock6->setChecked(dock6->isVisible());
    connect(ckb_dock6, &QCheckBox::clicked, this,[=](bool checked) {
        dock6->setVisible(checked);
    });
    connect(dock6,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock6->isChecked()==isVisible) return;
        ckb_dock6->setChecked(isVisible);
    });

    QCheckBox * ckb_dock7 = new QCheckBox("Dock7");
    toolBar->addWidget(ckb_dock7);
    ckb_dock7->setChecked(dock7->isVisible());
    connect(ckb_dock7, &QCheckBox::clicked, this,[=](bool checked) {
        dock7->setVisible(checked);
    });
    connect(dock7,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock7->isChecked()==isVisible) return;
        ckb_dock7->setChecked(isVisible);

    });

    QCheckBox * ckb_dock8 = new QCheckBox("Dock8");
    toolBar->addWidget(ckb_dock8);
    ckb_dock8->setChecked(dock8->isVisible());
    connect(ckb_dock8, &QCheckBox::clicked, this,[=](bool checked) {
        dock8->setVisible(checked);
    });
    connect(dock8,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock8->isChecked()==isVisible) return;
        ckb_dock8->setChecked(isVisible);
    });

    QCheckBox * ckb_dock9 = new QCheckBox("Dock9");
    toolBar->addWidget(ckb_dock9);
    ckb_dock9->setChecked(dock9->isVisible());
    connect(ckb_dock9, &QCheckBox::clicked, this,[=](bool checked) {
        dock9->setVisible(checked);
    });
    connect(dock9,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock9->isChecked()==isVisible) return;
        ckb_dock9->setChecked(isVisible);
    });

    QCheckBox * ckb_dock110 = new QCheckBox("Dock10");
    toolBar->addWidget(ckb_dock110);
    ckb_dock110->setChecked(dock10->isVisible());
    connect(ckb_dock110, &QCheckBox::clicked, this,[=](bool checked) {
        dock10->setVisible(checked);
    });
    connect(dock10,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock110->isChecked()==isVisible) return;
        ckb_dock110->setChecked(isVisible);
    });

    QCheckBox * ckb_dock11 = new QCheckBox("Dock11");
    toolBar->addWidget(ckb_dock11);
    ckb_dock11->setChecked(dock11->isVisible());
    connect(ckb_dock11, &QCheckBox::clicked, this,[=](bool checked) {
        dock11->setVisible(checked);
    });
    connect(dock11,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock11->isChecked()==isVisible) return;
        ckb_dock11->setChecked(isVisible);
    });

    QCheckBox * ckb_dock12 = new QCheckBox("Dock12");
    toolBar->addWidget(ckb_dock12);
    ckb_dock12->setChecked(dock12->isVisible());
    connect(ckb_dock12, &QCheckBox::clicked, this,[=](bool checked) {
        dock12->setVisible(checked);
    });
    connect(dock12,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dock12->isChecked()==isVisible) return;
        ckb_dock12->setChecked(isVisible);
    });

    QCheckBox * ckb_dockFloat = new QCheckBox("DockFloat");
    toolBar->addWidget(ckb_dockFloat);
    ckb_dockFloat->setChecked(true);
    connect(ckb_dockFloat, &QCheckBox::clicked, this,[=](bool checked) {
        dockFloat->setVisible(checked);
    });
    connect(dockFloat,&DockWidget::sg_visible,this,[=](bool isVisible){
        if(ckb_dockFloat->isChecked()==isVisible) return;
        ckb_dockFloat->setChecked(isVisible);
    });

    //setGeometry(QApplication::desktop()->availableGeometry());
    showMaximized();
    //setWindowState(Qt::WindowMaximized);
}
void MainWindow::test3()
{
    dock1 = dockManager->createDock(QIcon(":/image/res/openfile.png"),"DOCK1",dockLeft);
    dock1->setWidget(new QTextEdit("dock1"));

    dock2= new DockWidget(QIcon(":/image/res/palette.png"),"DOCK2");
    dock2->setWidget(new QTextEdit("dock2"));
    dockManager->tabifyDock(dock1,dock2);

    dock3 = dockManager->createDock(QIcon(":/image/res/openfile.png"),"DOCK3",dockLeft);
    dock3->setWidget(new QTextEdit("dock3"));

    dock4= new DockWidget(QIcon(":/image/res/palette.png"),"DOCK4");
    dock4->setWidget(new QTextEdit("dock4"));
    dockManager->tabifyDock(dock1,dock4);

    dock5 = dockManager->createDock(QIcon(":/image/res/openfile.png"),"DOCK5",dockLeft);
    dock5->setWidget(new QTextEdit("dock5"));

    dock6 = dockManager->createDock(QIcon(":/image/res/openfile.png"),"DOCK6",dockRight);
    dock6->setWidget(new QTextEdit("dock6"));

    dock7= new DockWidget(QIcon(":/image/res/palette.png"),"DOCK7");
    dock7->setWidget(new QTextEdit("dock7"));

    dock8= new DockWidget(QIcon(":/image/res/openfile.png"),"DOCK8");
    dock8->setWidget(new QTextEdit("dock8"));

    dockManager->tabifyDock(dock6,dock8);
    dockManager->splitDock(dock5,dock7,Qt::Vertical);

    dock9 = dockManager->createDock(QIcon(":/image/res/palette.png"),"DOCK9",dockTop);
    dock9->setWidget(new QTextEdit("dock9"));

    dock10 = dockManager->createDock(QIcon(":/image/res/openfile.png"),"DOCK10",dockBottom);
    dock10->setWidget(new QTextEdit("dock10"));

    dock11 = dockManager->createDock(QIcon(":/image/res/palette.png"),"DOCK11",dockBottom);
    dock11->setWidget(new QTextEdit("dock11"));;

    dock12=dockManager->createDock(QIcon(":/image/res/openfile.png"),"DOCK12",dockBottom);
    dock12->setWidget(new QTextEdit("dock12"));
}
void MainWindow::test4()
{
    dock1 = new DockWidget(QIcon(":/image/res/openfile.png"),"DOCK1");
    dock1->setWidget(new QTextEdit("dock1"));
    dockManager->addDock(dockLeft,dock1);

    dock2= new DockWidget(QIcon(":/image/res/palette.png"),"DOCK2");
    dock2->setWidget(new QTextEdit("dock2"));
    dockManager->tabifyDock(dock1,dock2);

    dock3= new DockWidget(QIcon(":/image/res/openfile.png"),"DOCK3");
    dock3->setWidget(new QTextEdit("dock3"));
    dockManager->addDock(dockLeft,dock3);

    dock4= new DockWidget(QIcon(":/image/res/palette.png"),"DOCK4");
    dock4->setWidget(new QTextEdit("dock4"));
    dockManager->tabifyDock(dock1,dock4);

    dock5= new DockWidget(QIcon(":/image/res/palette.png"),"DOCK5");
    dockManager->addDock(dockRight,dock5);
    dock5->setWidget(new QTextEdit("dock5"));

    dock6= new DockWidget(QIcon(":/image/res/openfile.png"),"DOCK6");
    dockManager->addDock(dockRight,dock6);
    dock6->setWidget(new QTextEdit("dock6"));


    dock7= new DockWidget(QIcon(":/image/res/palette.png"),"DOCK7");
    dock7->setWidget(new QTextEdit("dock7"));
    dock8= new DockWidget(QIcon(":/image/res/openfile.png"),"DOCK8");
    dock8->setWidget(new QTextEdit("dock8"));

    dockManager->tabifyDock(dock6,dock8);
    dockManager->splitDock(dock5,dock7,Qt::Vertical);

    dock9= new DockWidget(QIcon(":/image/res/openfile.png"),"DOCK9");
    dockManager->addDock(dockTop,dock9);
    dock9->setWidget(new QTextEdit("dock9"));

    dock10= new DockWidget(QIcon(":/image/res/openfile.png"),"DOCK10");
    dockManager->addDock(dockBottom,dock10);
    dock10->setWidget(new QTextEdit("dock10"));

    dock11= new DockWidget(QIcon(":/image/res/palette.png"),"DOCK11");
    dockManager->addDock(dockBottom,dock11);
    dock11->setWidget(new QTextEdit("dock11"));;

    dock12= new DockWidget(QIcon(":/image/res/palette.png"),"DOCK12");
    dockManager->addDock(dockBottom,dock12);
    dock12->setWidget(new QTextEdit("dock12"));
}

MainWindow::~MainWindow()
{
    delete ui;
}

void MainWindow::on_actionTest1_triggered()
{
    dock1->setPinned(3);
}


void MainWindow::on_actionTest2_triggered()
{
    dock10->setPinned(3);
}

void MainWindow::on_actionTest3_triggered()
{
    dock10->setPinned(2);
}

void MainWindow::updateTheme()
{
    QString sf= ":/style/res/default.qss";
    QFile file(sf);
    if (file.exists()) {
        file.open(QFile::ReadOnly);
        QString styleSheet = qApp->styleSheet();
        styleSheet +=tr(file.readAll());
        styleSheet += "QTextEdit{border:none;}";
        qApp->setStyleSheet(styleSheet);
        file.close();
    }
    m_dockTheme.setTheme();
}

图片1
在这里插入图片描述
图片2
在这里插入图片描述
图片3
在这里插入图片描述
资源下载地址https://download.youkuaiyun.com/download/dy2017/87606110

由于工作变动，代码不小心搞丢了，计划年底之前再实现一版，这个版本主要采用QSplitter类，下一个版本很可能是采用layout类实现

类似于Visual Studio的可停靠、可隐藏、抽屉状态Qt控件框架
04-05
基于DockWidget开发，提供类似于Visual Studio的可停靠、可隐藏、抽屉状态控件框架
QT基础九、浮动窗口：QDockWidget
最新发布
m0_75107602的博客
03-01 557
是 Qt 框架中的一个类，用于创建可停靠的窗口部件（Dockable Widget）。它通常被用来实现应用程序中的浮动面板或工具窗口，这些窗口可以停靠在主窗口的边缘、浮动在主窗口之外，或者隐藏起来。提供了灵活的用户界面布局功能，常用于需要高度定制化和动态调整界面的应用程序。vs的最右边的窗口就是一个浮动窗口。
Qt中QDockWidget的自定义标题栏
缘如风的博客
08-21 4688
本例有Qt的官网例子改写而来。效果如下： 具体代码如下 头文件 #ifndef CDOCWIDGETBAR_H #define CDOCWIDGETBAR_H #include <QWidget> class CDocWidgetBar : public QWidget { Q_OBJECT public: CDocWidgetBar(QWidget *pare...
嵌入式多媒体设计7--QDockWidget大小调整及隐藏标题
weixin_34130269的博客
04-09 507
做播放器当然少不了播放列表，播放列表又好几种形式，一种使用另外的窗口，如千千静听; 一种使用多标签，如酷狗音乐;一种使用停靠窗口，如QQ影音。由于我做的是播放器，是在 4.3寸的屏上运行，便选择了停靠窗口。 在Qt里停靠窗口是QDockWidget，它的显示区域如图，摘自Qt帮助文档。 可以对它的属性进行一系列的设置，具体的看帮助文档。 可是当我使用QDockWidget后发现，右边...
Qt 之QDockwidget 自定义窗口标题栏
fuyouzhiyi的博客
08-25 3524
这个比较简单，就是继承QWidget，挨个添加需要的控件即可，详情见源码三个地方注意构造函数QWidget *parent不设置默认值，确保调用的时候，把QDockwidget的指针传进来成员变量QPushButton* m_pButtonFloating;样式//获取qt默认图标 m_pButtonFloating = new QPushButton(floatIcon , "" , this);");......
自定义QDockWidget的标题栏
CodeCoding的博客
12-20 1155
自定义QDockWidget标题栏
QDockWidget自定义标题栏
xiaobai_cpp的博客
07-21 1975
停靠窗口(dockwindow)是指一些可以停靠在QMainWindow中或是浮动为独立窗口的窗口。QMainWindow提供了4个停靠窗口区域分别在中央窗口部件的上部、下部、左侧和右侧。在Qt中,各个停靠窗口都是QDockWidget的实例。每一个停靠窗口都有自己的标题栏,即使它处于停靠时也是如此。通过拖拽这一标题栏,用户可以把停靠窗口从一个停靠区域移动到另外一个停靠区域。通过把这个停靠窗口拖动到其他停靠区域的外面,就可以把停靠窗口从一个停靠区域中分离出来,让它成为一个独立的窗口。.........
QDockWidget嵌套布局详解-实现Visual Studio布局
not_give_up_的博客
05-08 814
QDockWidget嵌套布局详解-实现Visual Studio布局 标签： qt界面QDockWidge 2016-04-22 15:31 3109人阅读 评论(12) 收藏 举报 本文章已收录于： 分类： qt（17） 作者同类文章X 版权声明：本文为博主原创文章，未经博主允许不得转载。
QDockWidget之自定义标题栏
Black_Silencer的博客
05-08 1972
实现思路 自定义一个QWidget QDockWidget::setTitleBarWidget 自定义QWidget时候注意点 The title bar widget must have a valid QWidget::sizeHint() and QWidget::minimumSizeHint() 不想特别处理的鼠标事件，调用 QMouseEvent::ignore() 要注意标题栏方向 QDockWidget *dockWidget = qobject_cast<QD
QT的界面，多窗口自动停靠布局
02-09
QT的界面，多窗口自动停靠布局
QDockWidget多层嵌套布局示例
04-22
千万别下载，csdn私自修改我设置的积分（还不能改回来），去https://github.com/czyt1988/czyBlog/tree/master/tech/QDockWidget_VSStudioMode，下载源码。具体可见：http://blog.youkuaiyun.com/czyt1988/article/details/51209619
QDockWiddget实现界面布局
01-02
使用QT中的QDockWidget实现界面布局的划分，划分成类似于VS的界面布局
Qt主窗口 之：停靠/悬浮窗口(QDockWidget)
zxf347085420的博客
03-31 4573
信号可以用于监测停靠窗口的浮动状态的变化。根据应用程序的需求，你可以使用这些函数来自定义停靠窗口的行为和外观。是 Qt 中的一个窗口部件，用于创建可停靠的窗口，通常用于构建多文档接口（MDI）或可定制的用户界面。函数来创建一个切换停靠窗口可见性的操作，以便用户可以通过工具栏切换窗口的显示状态。类提供了一系列函数，用于配置和管理停靠式窗口的行为和外观。允许用户将窗口停靠在应用程序的主窗口周围，或将其拖动到独立的浮动窗口中。允许用户将窗口部件停靠在主窗口的各个位置，如左侧、右侧、上方或下方。
【QT开发】可停靠窗口的组件QDockWidget类详解及实战应用
科技改变人类，技术成就未来
07-19 1192
QDockWidget是Qt中用于创建可停靠窗口的组件，这些窗口可以作为应用程序主窗口的一部分显示。通过QDockWidget，用户可以将窗口停靠到主窗口的边缘或作为浮动窗口独立显示，为用户提供更灵活的工作空间管理。
Qt Widgets 之 QDockWidget（停靠窗口）
SummerPa的博客
07-10 3564
在 Qt 中，停靠窗口 (dock window) 都是QDockWidget 的实例，可以停靠在 QMainWindow 的中央部件 (central widget) 的上下左右四个区域，停靠的 QDockWidget 没有框架，有一个较小的标题栏；也可浮动出来作为独立窗口。 Qt 提供了很多相关示例，其中Main Window最为全面详细，我们今天就就着这个示例研究一下 QDockWidget 的用法及特性。 .......
实现Qt窗口停靠功能的Dockwidget教程
在自定义Dockwidget的标题栏时，这两个属性对于改善用户界面布局和视觉效果是很重要的。 在Qt中，QDockWidget类是专门用来实现停靠窗口的，它提供了一些方法，例如： - setAllowedAreas(Qt::DockWidgetAreas areas)...
QDockWidget 简单的自定义标题栏
weixin_45980869的博客
11-18 3125
QDockWidget 简单的自定义标题栏
评论 3
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值