Bootstrap

QDockWidget类详解

一.QDockWidget类概述

1.QDockWidget类

QDockWidget类提供了一个特殊的窗口部件,它可以是被锁在QMainWindow窗口内部或者是作为顶级窗口悬浮在桌面上。

QDockWidget类提供了dock widget的概念,dock widget也就是我们熟悉的工具面板或者是工具窗口。Dock window是放置在QMindow窗口周围的dock widget区域中的。

如下图所示:

Dock windows可以在几个区域中移动,或者是悬浮。该类提供的API允许程序员限制dock widgets的移动,悬浮和关闭,以及它可以被放置的区域。

注意:QDockWidget目前只有锁定在QMainWindow窗口内部,才能展现出QDockWidget应有的属性,如果将QDockWidget放到布局管理器当中,那么就只能当作QWidget使用了。

2.QDockWidget功能和QSplitter类有一定的类似之处,见之前文章:

QSplitter分裂器的使用方法:https://mp.csdn.net/mp_blog/creation/editor/138561130

二.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)

三.demo

1.MyForm.h

#ifndef MYFORM_H

#define MYFORM_H

#include "ui_form.h"

#include <QDockWidget>

class MyForm:public QDockWidget

{

    Q_OBJECT

public:

    explicit MyForm();

    ~MyForm();

private:

    Ui::Form *ui;

};

#endif // MYFORM_H

2.MyForm.cpp

#include "MyForm.h"

#include "ui_form.h"

MyForm::MyForm():ui(new Ui::Form)

{

    ui->setupUi(this);

}

MyForm::~MyForm()

{

    delete ui;

}

3.mywindow.h

#ifndef MYWINDOW_H

#define MYWINDOW_H

#include <QMainWindow>

namespace Ui {

class MyWindow;

}

class MyWindow : public QMainWindow

{

    Q_OBJECT

    

public:

    explicit MyWindow(QWidget *parent = 0);

    ~MyWindow();

    

private:

    Ui::MyWindow *ui;

};

#endif // MYWINDOW_H

4.mywindow.cpp

#include "mywindow.h"

#include "ui_mywindow.h"

#include <QTextEdit>

#include <QDockWidget>

#include "MyForm.h"

MyWindow::MyWindow(QWidget *parent) :

    QMainWindow(parent),

    ui(new Ui::MyWindow)

{

    ui->setupUi(this);

    QTextEdit *text = new QTextEdit("");

    text->append("");

    setCentralWidget(text);

    

    

    QDockWidget *dockWidget1 = new /*QDockWidget("A");*/ MyForm();

    addDockWidget(Qt::LeftDockWidgetArea,dockWidget1);

    QDockWidget *dockWidget2 = new QDockWidget("B");

    addDockWidget(Qt::RightDockWidgetArea,dockWidget2);

    QDockWidget *dockWidget3 = new QDockWidget("C");

    addDockWidget(Qt::TopDockWidgetArea,dockWidget3);

    QDockWidget *dockWidget4 = new QDockWidget("D");

    addDockWidget(Qt::BottomDockWidgetArea,dockWidget4);

}

MyWindow::~MyWindow()

{

    delete ui;

}

5.程序运行界面

悦读

道可道,非常道;名可名,非常名。 无名,天地之始,有名,万物之母。 故常无欲,以观其妙,常有欲,以观其徼。 此两者,同出而异名,同谓之玄,玄之又玄,众妙之门。

;