【QT】QDockWidget控件的使用

目录

1.概述

2.常用函数介绍

3.QDockWidget布局相关

4.QDockWidget的使用注意事项

5.使用场景

6.简单应用示例代码

1.概述

QDockWidget类提供了一个小部件，可以停靠在QMainWindow中，也可以作为桌面上的顶级窗口浮动。

QDockWidget提供了dock Widget的概念，也称为工具选项板或实用程序窗口。停靠窗口是放置在QMainWindow中心小部件周围的停靠小部件区域中的辅助窗口。停靠窗口可以在其当前区域内移动，移动到新区域，并由最终用户浮动（例如，取消停靠）。QDockWidget API允许程序员限制dock小部件移动、浮动和关闭的能力，以及它们可以放置的区域。

QDockWidget 的主要特点：

1. 停靠功能：QDockWidget 允许用户将窗口部件停靠在主窗口的各个位置，如左侧、右侧、上方或下方。

2. 浮动窗口：用户还可以将 QDockWidget 拖动到独立的浮动窗口中。

3. 可关闭：QDockWidget 可以关闭，允许用户根据需要隐藏或显示它。

4. 自定义部件：你可以将自定义的部件放在 QDockWidget 中，以构建自定义的界面元素。

2.常用函数介绍

QDockWidget 类提供了一系列函数，用于配置和管理停靠式窗口的行为和外观。以下是一些常用的 QDockWidget 函数的介绍和使用方法：

1.setWidget：设置停靠窗口中的部件

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

QWidget *customWidget = new QWidget;

dockWidget.setWidget(customWidget);

2.setAllowedAreas：设置允许停靠的区域

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

3.setFeatures：设置停靠窗口的功能特性，如关闭按钮、可浮动等

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

4.setWindowTitle：设置停靠窗口的标题

dockWidget.setWindowTitle("My Dock Widget");

5.setVisible：设置停靠窗口的可见性

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