QT界面：QDockWidget停靠窗口使用小结

QDockWidget停靠窗口

Qt构建停靠窗口使用的是QDockWidget类。

窗口特性

停靠窗口特性可以通过setFeatures(QDockWidget::AllDockWidgetFeatures)方法进行设置：

常亮	值	描述
QDockWidget::DockWidgetClosable	0x01	窗口可关闭
QDockWidget::DockWidgetMovable	0x02	窗口可移动
QDockWidget::DockWidgetFloatable	0x04	停靠窗口可以与主窗口分离，作为独立窗口浮动
QDockWidget::DockWidgetVerticalTitleBar	0x08	停靠窗口在左侧显示垂直标题栏。用于增加QMainWindow中的垂直空间。
QDockWidget::AllDockWidgetFeatures	DockWidgetClosable /DockWidgetMovable / DockWidgetFloatable	（不建议使用）可以关闭，移动和浮动停靠窗口
QDockWidget::NoDockWidgetFeatures	0x00	停靠窗口不可关闭、移动、浮动

停靠区域

通过setAllowedAreas(Qt::DockWidgetAreas areas)设置窗口停靠区域：

常亮	值
Qt::LeftDockWidgetArea	0x1
Qt::RightDockWidgetArea	0x2
Qt::TopDockWidgetArea	0x4
Qt::BottomDockWidgetArea	0x8
Qt::AllDockWidgetAreas	DockWidgetArea_Mask
Qt::NoDockWidgetArea	0

隐藏与显示

窗口的隐藏与显示可通过hide()、show()实现，判断窗口的显示与隐藏状态可用isHidden()。

示例

环境：Win10+VS2015+Qt5.9.7

首先创建一个Qt GUI Application。工程名：myDockWidget。然后，在资源文件中添加一幅图像资源：

头文件

myDockWidget.h：

#pragma once#include <QtWidgets/QMainWindow>
#include <QHBoxLayout>
#include <QPushButton>
#include <QRadioButton>
#include <QCheckBox>
#include <QSpinBox>
#include <QLabel>
#include <QTextEdit>
#include <QDockWidget>#include "ui_myDockWidget.h"#pragma execution_character_set("utf-8")class myDockWidget : public QMainWindow
{Q_OBJECTpublic:myDockWidget(QWidget *parent = Q_NULLPTR);private:Ui::myDockWidgetClass ui;
};

源文件

myDockWidget.cpp：

在停靠窗口中添加一些控件资源。

#include "myDockWidget.h"myDockWidget::myDockWidget(QWidget *parent): QMainWindow(parent)
{ui.setupUi(this);//显示——停靠窗口QLabel *m_qLabel = new QLabel("", this);m_qLabel->setAlignment(Qt::AlignCenter);m_qLabel->setStyleSheet("border-image: url(:/myDockWidget/Resources/image.jpg);");m_qLabel->setMinimumWidth(500);m_qLabel->setMinimumHeight(300);QHBoxLayout *hlayout0 = new QHBoxLayout;hlayout0->addWidget(m_qLabel);QGridLayout *vlayout0 = new QGridLayout;vlayout0->addLayout(hlayout0, 0, 0);QWidget *cornerWidget0 = new QWidget;cornerWidget0->setLayout(vlayout0);setCentralWidget(cornerWidget0);//调试——停靠窗口QDockWidget *debugging = new QDockWidget("调试", this);//构建停靠窗口，指定父类debugging->setFeatures(QDockWidget::DockWidgetMovable | QDockWidget::DockWidgetClosable);//设置停靠窗口特性，可移动，可关闭debugging->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);//设置可停靠区域为主窗口左边和右边debugging->setMinimumWidth(200);QTextEdit *debuggingEdit = new QTextEdit("调试——停靠窗口);debugging->setWidget(debuggingEdit);addDockWidget(Qt::RightDockWidgetArea, debugging);//测试——停靠窗口QDockWidget *dw3 = new QDockWidget("测试", this);//构建停靠窗口，指定父类dw3->setFeatures(QDockWidget::DockWidgetMovable);//设置停靠窗口特性，可移动，可关闭dw3->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);//设置可停靠区域为主窗口左边和右边QHBoxLayout *hlayout31 = new QHBoxLayout;QPushButton *runPushButton = new QPushButton(tr("运行"));QPushButton *stopPushButton = new QPushButton(tr("停止"));hlayout31->addWidget(runPushButton);hlayout31->addWidget(stopPushButton);QGridLayout *vlayout3 = new QGridLayout;vlayout3->addLayout(hlayout31, 0, 0);QWidget *cornerWidget3 = new QWidget;cornerWidget3->setLayout(vlayout3);dw3->setWidget(cornerWidget3);dw3->setMaximumHeight(100);dw3->setMaximumWidth(300);addDockWidget(Qt::LeftDockWidgetArea, dw3);}

效果如图：

为停靠窗口中的控件添加槽函数

头文件