目录
1.概述
QDockWidget类提供了一个小部件,可以停靠在QMainWindow中,也可以作为桌面上的顶级窗口浮动。
QDockWidget提供了dock Widget的概念,也称为工具选项板或实用程序窗口。停靠窗口是放置在QMainWindow中心小部件周围的停靠小部件区域中的辅助窗口。停靠窗口可以在其当前区域内移动,移动到新区域,并由最终用户浮动(例如,取消停靠)。QDockWidget API允许程序员限制dock小部件移动、浮动和关闭的能力,以及它们可以放置的区域。
![](https://i-blog.csdnimg.cn/blog_migrate/9f0f457c01d0c7e7f5f10757a501ade2.png)
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); // 显示停靠窗口