一、QDockWidget概述
QDockWidget
是 Qt 中的一个窗口部件,用于创建可停靠的窗口,通常用于构建多文档接口(MDI)或可定制的用户界面。QDockWidget
允许用户将窗口停靠在应用程序的主窗口周围,或将其拖动到独立的浮动窗口中。
以下是有关 QDockWidget
的详细介绍和使用方法:
QDockWidget
的主要特点:
-
停靠功能:QDockWidget
允许用户将窗口部件停靠在主窗口的各个位置,如左侧、右侧、上方或下方。
-
浮动窗口:用户还可以将 QDockWidget
拖动到独立的浮动窗口中。
-
可关闭:QDockWidget
可以关闭,允许用户根据需要隐藏或显示它。
-
自定义部件:你可以将自定义的部件放在 QDockWidget
中,以构建自定义的界面元素。
二、常用函数介绍
QDockWidget
类提供了一系列函数,用于配置和管理停靠式窗口的行为和外观。以下是一些常用的 QDockWidget
函数的介绍和使用方法:
1.setWidget:设置停靠窗口中的部件
1 2 3 | QDockWidget dockWidget( "标题" , &mainWindow); QWidget *customWidget = new QWidget; dockWidget.setWidget(customWidget); |
2.setAllowedAreas:设置允许停靠的区域
1 | dockWidget.setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea); |
3.setFeatures:设置停靠窗口的功能特性,如关闭按钮、可浮动等
1 | dockWidget.setFeatures(QDockWidget::DockWidgetClosable | QDockWidget::DockWidgetMovable); |
4.setWindowTitle:设置停靠窗口的标题
1 | dockWidget.setWindowTitle( "My Dock Widget" ); |
5.setVisible:设置停靠窗口的可见性
1 | dockWidget.setVisible( true ); // 显示停靠窗口 |
6.isFloating:检查停靠窗口是否在浮动状态
1 | bool isFloating = dockWidget.isFloating(); |
7.close:关闭停靠窗口
8.toggleViewAction:获取一个 QAction 对象,用于在工具栏中切换停靠窗口的可见性
1 2 | QAction *toggleAction = dockWidget.toggleViewAction(); toolBar->addAction(toggleAction); |
9.topLevelChanged 信号:在停靠窗口的浮动状态发生变化时触发
1 2 3 4 5 6 7 | QObject::connect(&dockWidget, &QDockWidget::topLevelChanged, [&]( bool floating) { if (floating) { qDebug() << "窗口已浮动" ; } else { qDebug() << "窗口已停靠" ; } }); |
这些函数可以帮助你配置 QDockWidget
控件的各种属性,包括设置停靠区域、标题、可见性、功能特性等。你还可以使用 toggleViewAction
函数来创建一个切换停靠窗口可见性的操作,以便用户可以通过工具栏切换窗口的显示状态。topLevelChanged
信号可以用于监测停靠窗口的浮动状态的变化。根据应用程序的需求,你可以使用这些函数来自定义停靠窗口的行为和外观。
三、示例代码如下
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 | #include "main_window.h" #include <QDockWidget> #include <QTextEdit> MainWindow::MainWindow(QWidget *parent) : QMainWindow(parent) { this ->setWindowTitle( "停靠窗口" ); this ->setFixedSize(600, 400); QTextEdit *pTextEdit = new QTextEdit( this ); pTextEdit->setText( "主窗口测试" ); pTextEdit->setAlignment(Qt::AlignLeft); this ->setCentralWidget(pTextEdit); //停靠窗口实现 QDockWidget *pDock = new QDockWidget( "停靠窗口1" , this ); pDock->setFeatures(QDockWidget::DockWidgetMovable); pDock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea); QTextEdit *pText1 = new QTextEdit( this ); pText1->setText( "你好" ); pDock->setWidget(pText1); this ->addDockWidget(Qt::RightDockWidgetArea, pDock); } |
效果如下: