qt QDockWidget总结

1. 概述

• QDockWidget 是 Qt 中用于创建可停靠窗口的组件，通常依附于主窗口（QMainWindow）的四周（上下左右），用户可拖动、浮动或调整其位置。
• 适用于需要灵活布局的场景（如 IDE 中的工具窗口、属性面板等）。

2. 主要特性

• 可停靠性：可拖拽到主窗口的任意允许区域（Qt::DockWidgetArea）。
• 浮动支持：可脱离主窗口成为独立窗口（浮动模式）。
• 动态布局：用户可自定义布局，布局信息可通过 QMainWindow::saveState() 保存。
• 内容自定义：通过 setWidget() 设置内容部件。

3. 常用方法

4. 信号与槽

5. 使用步骤

1. 创建主窗口：需基于 QMainWindow（DockWidget 依附于主窗口）。
2. 创建 DockWidget：实例化 QDockWidget 并设置内容部件。
3. 添加到主窗口：通过 QMainWindow::addDockWidget() 添加。
4. 设置属性：如允许停靠的区域、是否可关闭等。
5. 处理信号（可选）：如响应浮动状态变化。

6. 示例代码

#include <QMainWindow>
#include <QDockWidget>
#include <QTextEdit>

class MainWindow : public QMainWindow {
public:
    MainWindow(QWidget *parent = nullptr) : QMainWindow(parent) {
        // 创建主窗口中心部件
        QTextEdit *centralWidget = new QTextEdit(this);
        setCentralWidget(centralWidget);

        // 创建 DockWidget
        QDockWidget *dock = new QDockWidget("工具窗口", this);
        QTextEdit *dockContent = new QTextEdit(dock);
        dock->setWidget(dockContent);

        // 设置 DockWidget 属性
        dock->setAllowedAreas(Qt::LeftDockWidgetArea | Qt::RightDockWidgetArea);
        dock->setFeatures(QDockWidget::DockWidgetClosable | QDockWidget::DockWidgetMovable);

        // 将 DockWidget 添加到主窗口左侧
        addDockWidget(Qt::LeftDockWidgetArea, dock);
    }
};

7. 注意事项

• 内存管理：确保 DockWidget 或其内容部件的父对象正确，避免内存泄漏。
• 主窗口依赖：必须有一个 QMainWindow 作为主窗口，且需设置中心部件（setCentralWidget()）。
• 布局冲突：多个 DockWidget 可能互相遮挡，需合理设置停靠顺序或使用 tabifyDockWidget() 合并标签页。
• 样式调整：浮动时的窗口样式可能与主窗口不同，需注意跨平台一致性。
• 平台差异：某些操作系统对浮动窗口的行为可能有特殊限制。