在Giu项目中限制子窗口在MasterWindow内部显示的技术方案

在Giu项目（基于Dear ImGui的Go语言封装）开发多窗口应用时，开发者可能会遇到子窗口超出主窗口边界的问题。本文将深入分析问题原因并提供三种有效的解决方案。

问题背景分析

当使用Giu的多窗口功能时，子窗口默认可以移动到主窗口(MasterWindow)之外。这种现象源于两个技术特性：

1. 默认启用了多视口(viewport)功能
2. 窗口位置坐标默认基于屏幕绝对坐标系而非相对主窗口坐标系

解决方案一：完全禁用多视口功能

最直接的解决方案是关闭多视口功能，强制所有窗口都在主窗口内渲染：

imgui.CurrentIO().SetConfigFlags(imgui.CurrentIO().ConfigFlags() & ^imgui.ConfigFlagsViewportsEnable)

此方法简单有效，但会失去多视口带来的灵活性，如将窗口拖出主窗口成为独立系统窗口的能力。

解决方案二：调整窗口相对位置

如果希望保留多视口功能，但控制窗口初始位置，可以手动调整窗口坐标：

vp := imgui.MainViewport().Pos()
giu.Window("窗口标题").
    Pos(0+vp.X, 0+vp.Y).
    Layout(
        giu.Label("内容区域"),
    )

这种方法通过获取主视口位置并作为偏移量，确保窗口初始位置正确。但需要注意后续窗口拖动仍可能移出主窗口。

解决方案三：结合窗口标志控制

借鉴Dear ImGui原生解决方案，可以设置特定窗口标志：

giu.Window("窗口标题").
    Flags(
        giu.WindowFlagsNoCollapse |
        giu.WindowFlagsNoBringToFrontOnFocus |
        giu.WindowFlagsNoDocking,
    ).
    Layout(
        giu.Label("内容区域"),
    )

这种方法通过组合多个窗口标志，实现了：

• 禁止窗口折叠
• 禁止获取焦点时前置
• 禁止停靠功能

方案对比与选型建议

方案	保留多视口	实现复杂度	灵活性	适用场景
禁用多视口	❌	低	低	简单应用
调整位置	✅	中	中	需要初始位置控制
窗口标志	✅	高	高	需要精细控制

对于大多数应用，方案三提供了最佳的灵活性和控制力。如果应用场景简单，方案一也是不错的选择。方案二适合需要精确控制初始位置但保留多视口功能的场景。

实现细节注意事项

1. 坐标转换：在主窗口移动后，相对坐标需要重新计算
2. 窗口尺寸：应考虑主窗口尺寸变化对子窗口的影响
3. 多显示器环境：在多显示器配置下，坐标计算需要额外注意
4. 性能影响：频繁的位置计算可能影响渲染性能

通过合理选择上述方案，开发者可以有效地控制Giu应用中窗口的显示范围，提升用户体验和界面一致性。