OpenBoard项目在Qt6环境下的多显示器布局问题解析

问题现象

在Qt6环境下运行OpenBoard时，用户界面出现多个几何布局异常：

1. 工具栏图标间距异常紧凑
2. 右侧调色板(palette)无法保持用户调整后的大小
3. 文档打开后无法居中显示
4. 多显示器模式下控制屏和显示屏会错误地呈现在同一显示器上

环境特征

该问题特定出现在以下环境组合：

• Qt6版本：6.6.3和6.7.2均受影响
• 操作系统：Linux（openSUSE Leap 15.6和滚动更新版）
• 显示配置：双显示器环境（单显示器下问题不出现）
• 窗口系统：X11

技术分析

通过调试发现，核心问题在于Qt6的窗口几何属性管理机制发生了变化。关键发现点包括：

1. setGeometry失效：

   • 代码中调用setGeometry()设置窗口位置和尺寸后，实际获取的geometry值显示设置未生效
   • 示例调试输出显示设置1920x1080的矩形，实际获取到的是400x163的默认尺寸

2. 多显示器坐标处理：

   • 系统能正确识别多显示器配置（如主显示器1920x1080，副显示器1680x1050）
   • 但窗口无法正确定位到指定显示器的坐标空间

3. 工作区切换影响：

   • 在文档模式和画板模式间切换时，工具栏布局会恢复正常
   • 启用/禁用多屏模式会影响文档居中状态

解决方案

经过验证的有效解决方法是组合使用move()和resize()替代setGeometry()：

// 原始代码
controlWidget->setGeometry(geometry);

// 修正方案
controlWidget->move(geometry.topLeft());
controlWidget->resize(geometry.size());
UBPlatformUtils::showFullScreen(controlWidget);

这种方案在Qt6环境下能确保：

• 窗口正确定位到目标显示器的指定坐标
• 窗口尺寸按预期设置
• 在多显示器配置下保持稳定

兼容性考虑

值得注意的是：

1. 该问题在不同Linux发行版上表现可能不一致
2. 虚拟显示器环境下可能不会复现
3. Qt5环境不受此问题影响

最佳实践建议

对于跨Qt版本开发的应用，推荐：

1. 对窗口几何操作进行Qt版本判断
2. 在关键几何操作后添加验证逻辑
3. 考虑同时使用setGeometry和move/resize组合确保兼容性

该修复方案已合并到项目主分支，为使用Qt6的多显示器用户提供了稳定的布局体验。