Qt QDockWidget使用详解：打造可停靠式唐诗宋词阅读器

一、QDockWidget核心功能

QDockWidget 是Qt中用于创建可停靠窗口的核心控件，具有以下特性：

• 可停靠在主窗口四周（左/右/上/下）
• 支持浮动模式（作为独立窗口）
• 可通过拖拽标题栏改变位置
• 可最大化

二、实现步骤详解

1. 创建项目并设计UI

1. 新建Qt Widgets Application项目
2. 打开mainwindow.ui文件
3. 从左侧控件栏拖拽以下控件：
   • 2个QDockWidget（重命名为dockWidgetTang和dockWidgetSong）
   • 2个QListWidget放置到每个DockWidget中

2. 编辑诗词内容

在ListWidget属性面板中操作：

1. 右键点击listWidgetTang → 编辑项目
2. 添加唐诗条目：
   • 《静夜思》
   • 《草》
3. 同样方式为宋词ListWidget添加条目

3. 添加Action

1. 双击菜单栏输入"视图" “关于”
2. 添加两个Action：
   • 名称：actionTang，文本：“唐诗”
   • 名称：actionSong，文本：“宋词”
3. 关键设置：勾选checkable属性

4. 信号槽连接（关键步骤）

在UI设计器中操作：

1. 右键"唐诗"Action → 转到槽 → triggered(bool)
2. 右键dockWidgetTang → 转到槽 → visibilityChanged(bool)
3. 重复以上步骤为宋词设置信号槽

三、效果展示

四、核心代码实现

// 当唐诗Action被触发时
void MainWindow::on_actionTang_triggered(bool checked)
{
    // 设置停靠窗口的可见性与Action状态同步
    ui->dockWidgetTang->setVisible(checked);
}

// 当宋词Action被触发时
void MainWindow::on_actionSong_triggered(bool checked)
{
    ui->dockWidgetSong->setVisible(checked);
}

// 当唐诗停靠窗口可见性变化时
void MainWindow::on_dockWidgetTang_visibilityChanged(bool visible)
{
    // 更新Action的勾选状态
    ui->actionTang->setChecked(visible);
}

// 当宋词停靠窗口可见性变化时
void MainWindow::on_dockWidgetSong_visibilityChanged(bool visible)
{
    ui->actionSong->setChecked(visible);
}

六、项目结构总结

七、常见问题解决

1. 停靠窗口无法拖动？

   • 检查features属性是否包含DockWidgetMovable
   • 确认allowedAreas设置了合适的区域

2. Action勾选状态不同步？

   • 确保正确连接visibilityChanged信号
   • 检查槽函数中的对象命名是否与UI文件一致

3. 布局混乱如何恢复？

   // 添加"重置布局"Action
   void MainWindow::on_actionReset_triggered()
   {
       ui->dockWidgetTang->setFloating(false);
       ui->dockWidgetSong->setFloating(false);
       addDockWidget(Qt::LeftDockWidgetArea, ui->dockWidgetTang);
       addDockWidget(Qt::LeftDockWidgetArea, ui->dockWidgetSong);
       tabifyDockWidget(ui->dockWidgetTang, ui->dockWidgetSong);
   }
   

八、应用场景拓展

QDockWidget非常适合需要多面板协作的应用：

1. 开发IDE（代码编辑区+文件树+调试窗口）
2. 图像处理软件（工具箱+图层+属性面板）
3. 数据分析工具（数据表格+图表+控制台）
4. 文档编辑器（目录树+注释面板+书签）