【Qt控件之QDockWidget 】使用

概述

QDockWidget类提供了一个窗口部件，可以被停靠在QMainWindow中，或作为桌面上的顶层窗口浮动显示。
QDockWidget提供了停靠窗口的概念，也称为工具暂存区或实用程序窗口。停靠窗口是次要窗口，放置在QMainWindow中心窗口周围的停靠窗口区域。

停靠窗口可以在其当前区域内移动，移动到新区域并由最终用户浮动（例如，取消停靠）。QDockWidget API允许程序员限制停靠窗口移动、浮动和关闭的能力，以及它们可以放置的区域。

外观

QDockWidget由标题栏和内容区域组成。标题栏显示了停靠窗口的窗口标题、浮动按钮和关闭按钮。根据QDockWidget的状态，浮动和关闭按钮可能被禁用或根本不显示。
标题栏和按钮的视觉外观取决于正在使用的风格。
QDockWidget作为其子窗口部件的封装，使用setWidget()设置。自定义大小提示、最小和最大尺寸以及大小策略应在子窗口部件中实现。QDockWidget将认可它们，调整自己的限制以包括框架和标题。不应在QDockWidget本身上设置尺寸约束，因为它们会根据是否停靠而改变；停靠的QDockWidget没有框架和较小的标题栏。

常用函数

QDockWidget::DockWidgetFeature枚举类型

DockWidgetFeatures类型是QFlags<DockWidgetFeature>的typedef。它存储DockWidgetFeature值的OR组合。

成员方法

1. QDockWidget(const QString &title, QWidget *parent = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags())：构造函数，创建一个带有标题的QDockWidget对象。title是窗口的标题，parent是父部件，flags是窗口标识符。
2. QDockWidget(QWidget *parent = Q_NULLPTR, Qt::WindowFlags flags = Qt::WindowFlags())：构造函数，创建一个没有标题的QDockWidget对象。 parent是父部件，flags是窗口标识符。
3. ~QDockWidget()：析构函数，销毁QDockWidget对象。
4. Qt::DockWidgetAreas allowedAreas() const：返回QDockWidget可以停靠的区域。
5. DockWidgetFeatures features() const：返回QDockWidget的功能标志。
6. bool isAreaAllowed(Qt::DockWidgetArea area) const：检查特定区域是否允许停靠QDockWidget。
7. bool isFloating() const：检查QDockWidget是否被浮动（未停靠）。
8. void setAllowedAreas(Qt::DockWidgetAreas areas)：设置QDockWidget可以停靠的区域。
9. void setFeatures(DockWidgetFeatures features)：设置QDockWidget的功能标志。
10. void setFloating(bool floating)：设置QDockWidget是否被浮动（未停靠）。
11. void setTitleBarWidget(QWidget *widget)：将给定的QWidget对象设置为QDockWidget的标题栏。
12. void setWidget(QWidget *widget)：将给定的QWidget对象设置为QDockWidget的子部件。
13. QWidget *titleBarWidget() const：返回QDockWidget的标题栏部件。
14. QAction *toggleViewAction() const：返回可用于切换QDockWidget可见性的QAction对象。
15. QWidget *widget() const：返回QDockWidget的子部件。

示例

#include <QtWidgets>

int