【Qt开发】Qt窗口（四） -＞ QDockWidget浮动窗口

文章目录

[1 -> 概述](#1 -> 概述)
[2 -> QDockWidget的核心特性](#2 -> QDockWidget的核心特性)
- [2.1 -> 停靠与浮动机制](#2.1 -> 停靠与浮动机制)
- [2.2 -> 灵活的停靠区域](#2.2 -> 灵活的停靠区域)
- [2.3 -> 可定制的标题栏](#2.3 -> 可定制的标题栏)
- [2.4 -> 状态持久化](#2.4 -> 状态持久化)
[3 -> QDockWidget的应用场景](#3 -> QDockWidget的应用场景)
- [3.1 -> 工具面板与调色板](#3.1 -> 工具面板与调色板)
- [3.2 -> 属性编辑器与配置窗口](#3.2 -> 属性编辑器与配置窗口)
- [3.3 -> 日志输出与调试信息](#3.3 -> 日志输出与调试信息)
- [3.4 -> 导航与资源管理器](#3.4 -> 导航与资源管理器)
[4 -> 设计考量与最佳实践](#4 -> 设计考量与最佳实践)
- [4.1 -> 用户体验优化](#4.1 -> 用户体验优化)
- [4.2 -> 性能与内存管理](#4.2 -> 性能与内存管理)
- [4.3 -> 多平台兼容性](#4.3 -> 多平台兼容性)
- [4.4 -> 可访问性支持](#4.4 -> 可访问性支持)
[5 -> 浮动窗口的创建](#5 -> 浮动窗口的创建)
- [5.1 -> 创建](#5.1 -> 创建)
- [5.2 -> 设置停靠的位置](#5.2 -> 设置停靠的位置)
[6 -> 总结](#6 -> 总结)

1 -> 概述

在现代图形用户界面开发中，窗口布局的灵活性和用户体验的个性化需求日益增长。Qt框架作为跨平台的C++应用程序开发工具，提供了强大的GUI组件库，其中QDockWidget作为实现可停靠浮动窗口的核心组件，在构建模块化、可定制的用户界面方面发挥着至关重要的作用。

QDockWidget是一种特殊的窗口容器，它可以附着在应用程序主窗口的四周（顶部、底部、左侧或右侧），也可以作为独立窗口浮动在桌面上。这种设计理念源于经典的集成开发环境（如Visual Studio、Qt Creator等）的界面布局，为用户提供了高度自由的工作区配置能力。通过QDockWidget，开发者能够创建出既保持界面整洁，又能根据用户偏好动态调整的现代化应用程序。

2 -> QDockWidget的核心特性

2.1 -> 停靠与浮动机制

QDockWidget最显著的特点是能够在停靠状态和浮动状态之间无缝切换。在停靠状态下，它作为主窗口的一个固定区域存在，与其他部件共享应用程序窗口空间；而在浮动状态下，它成为独立的顶级窗口，可以移动到屏幕的任何位置，甚至跨越多个显示器。这种双重状态的设计极大地增强了应用程序的适应性，使用户能够根据当前任务需求优化工作空间布局。

2.2 -> 灵活的停靠区域

每个QDockWidget可以被放置在四个主要的停靠区域之一：左、右、上、下。Qt的停靠系统支持精细的布局控制，允许开发者为每个停靠区域设置接受或拒绝特定类型的QDockWidget。此外，多个QDockWidget可以在同一停靠区域内以标签页的形式堆叠，或者通过分隔条并排显示，进一步优化了屏幕空间的利用率。

2.3 -> 可定制的标题栏

每个QDockWidget都配有标准的标题栏，包含窗口标题、浮动按钮和关闭按钮。开发者可以完全自定义这个标题栏的外观和行为，包括添加自定义控件、修改按钮样式或完全替换为自定义的标题栏组件。这种灵活性使得QDockWidget能够完美融入应用程序的整体视觉设计，同时保持其功能完整性。

2.4 -> 状态持久化

专业的应用程序通常需要记住用户的界面偏好。QDockWidget与QMainWindow紧密集成，支持布局状态的保存和恢复。通过Qt的状态保存机制，应用程序可以记住每个QDockWidget的位置、大小和停靠状态，在下次启动时自动恢复，为用户提供连续一致的体验。

3 -> QDockWidget的应用场景

3.1 -> 工具面板与调色板

在图形设计软件、视频编辑器和IDE中，QDockWidget常用于承载各种工具面板，如画笔设置、图层管理、属性检查器等。用户可以根据工作需要显示或隐藏这些面板，也可以将它们组合在屏幕的一侧，形成高效的工作流。

3.2 -> 属性编辑器与配置窗口

许多专业软件使用QDockWidget来显示当前选中对象的属性编辑器。当用户选择不同对象时，属性编辑器自动更新内容，同时保持在同一屏幕位置，减少了用户的视线移动和鼠标操作。

3.3 -> 日志输出与调试信息

开发工具和服务器管理程序经常使用QDockWidget来容纳日志输出窗口、调试信息或实时数据监控面板。这些窗口通常停靠在主窗口底部，既不会干扰主要工作区，又能提供持续的信息反馈。

3.4 -> 导航与资源管理器

文件管理器、项目管理工具常用QDockWidget实现目录树、资源浏览器或书签面板。这些组件通常固定在界面一侧，为用户提供快速的导航访问，同时保持内容区域的专注性。

4 -> 设计考量与最佳实践

4.1 -> 用户体验优化

在使用QDockWidget时，需要仔细考虑用户体验。过多的浮动窗口可能导致界面混乱，增加用户的认知负担。建议提供合理的默认布局，允许高级用户自定义，同时为新手用户保持简洁。提供窗口布局的重置功能也是一个好的实践，让用户能够轻松恢复到原始状态。

4.2 -> 性能与内存管理

虽然QDockWidget提供了极大的灵活性，但需要注意到每个浮动窗口都会增加系统的资源消耗。在创建大量QDockWidget时，应考虑延迟加载机制，仅在需要时创建窗口内容。同时，确保正确管理QDockWidget的生命周期，避免内存泄漏。

4.3 -> 多平台兼容性

不同操作系统对浮动窗口的处理方式存在差异。在设计和测试QDockWidget布局时，需要在所有目标平台上验证其行为，确保一致的用户体验。特别是要注意不同系统下窗口装饰、拖放行为和屏幕边界处理的差异。

4.4 -> 可访问性支持

为QDockWidget提供完整的可访问性支持是开发现代应用程序的重要方面。包括正确的键盘导航、屏幕阅读器支持和足够的颜色对比度等，确保所有用户都能充分利用应用程序的功能。

5 -> 浮动窗口的创建

在Qt中，浮动窗口也称之为铆接部件。浮动窗口是通过 QDockWidget类 来实现的功能。浮动窗口一般是位于核心部件的周围，可以有多个。

5.1 -> 创建

浮动窗口的创建是通过 QDockWidget类 提供的构造方法 QDockWidget()函数 动态创建。

cpp 复制代码

QDockWidget* dockWidget = new QDockWidget();
this->addDockWidget(Qt::LeftDockWidgetArea, dockWidget);

5.2 -> 设置停靠的位置

浮动窗口是位于中心部件的周围 。可以通过 QDockWidget类 中提供的 setAllowedAreas() 函数设置其允许停靠的位置。其中可以设置允许停靠的位置有：

Qt::LeftDockWidgetArea 停靠在左侧
Qt::RightDockWidgetArea 停靠在右侧
Qt::TopDockWidgetArea 停靠在顶部
Qt::BottomDockWidgetArea 停靠在底部
Qt::AllDockWidgetAreas 以上四个位置都可以停靠

cpp 复制代码

#include "mainwindow.h"
#include "ui_mainwindow.h"

#include <QDockWidget>
#include <QLabel>
#include <QPushButton>
#include <QVBoxLayout>

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);

    QDockWidget* dockWidget = new QDockWidget();
    this->addDockWidget(Qt::LeftDockWidgetArea, dockWidget);

    // 可以给浮动窗口设置标题
    dockWidget->setWindowTitle("这是一个标题");

    // 给浮动窗口内部, 添加一些其他的控件
    // 不能直接给这个浮动窗口添加子控件, 而是需要创建出一个单独的 QWidget, 把要添加的控件加入到 QWidget 中
    // 然后再把这个 QWidget 设置到 dockWidget 中
    QWidget* container = new QWidget();
    dockWidget->setWidget(container);

    // 创建布局管理器, 把布局管理器设置到 QWidget 中
    QVBoxLayout* layout = new QVBoxLayout();
    container->setLayout(layout);

    QLabel* label = new QLabel("这是一个 QLabel");
    QPushButton* button = new QPushButton("这是一个按钮");
    layout->addWidget(label);
    layout->addWidget(button);

    // 设置滑动窗口允许停靠的位置
    dockWidget->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);


}

MainWindow::~MainWindow()
{
    delete ui;
}

6 -> 总结

QDockWidget是Qt框架中一个功能强大且灵活的组件，它为创建现代化、可定制的用户界面提供了坚实的基础。通过合理的停靠区域管理、状态持久化和自定义选项，开发者可以构建出既专业又用户友好的应用程序界面。

在当今软件界面设计越来越注重个性化和效率的背景下，QDockWidget的价值更加凸显。它允许用户根据个人工作习惯和任务需求优化界面布局，从而提升工作效率和满意度。同时，对于开发者而言，QDockWidget的丰富API和高度可定制性意味着几乎可以实现任何类型的浮动窗口需求。

然而，强大的功能也伴随着责任。开发者需要谨慎使用QDockWidget，避免创建过于复杂的界面，始终以用户体验为中心进行设计决策。通过遵循最佳实践、进行充分的跨平台测试和关注可访问性，QDockWidget将成为构建高质量桌面应用程序的利器。

随着Qt框架的持续发展，我们可以期待QDockWidget在未来版本中会引入更多现代化特性，如更好的高DPI支持、增强的拖放体验和更流畅的动画效果，进一步丰富开发者的工具箱，助力创建更加出色的应用程序界面。

感谢各位大佬支持！！！

互三啦！！！