Godot引擎中PopupMenu滚动时工具提示显示错误的解决方案分析

问题背景

在Godot游戏引擎的GUI系统中，PopupMenu控件在用户滚动菜单后会出现工具提示显示错误的问题。具体表现为：当菜单项数量较多导致出现滚动条时，滚动后鼠标悬停在菜单项上会显示错误的工具提示内容。

问题重现与表现

通过创建一个包含大量菜单项的PopupMenu可以轻松重现此问题。当菜单项超过可视区域时，用户需要滚动查看更多选项。此时，滚动后悬停在菜单项上，显示的工具提示并非当前菜单项对应的提示，而是其他位置的提示内容。

技术原因分析

经过代码审查发现，问题的根源在于PopupMenu控件处理鼠标位置和工具提示显示的机制存在缺陷。具体来说：

1. PopupMenu的get_tooltip方法依赖于_get_mouse_over方法来确定当前鼠标悬停的菜单项
2. _get_mouse_over方法期望接收的鼠标位置是相对于菜单Viewport的坐标
3. 但实际上Viewport的_gui_get_tooltip方法传递的是相对于控件的坐标

这种坐标系统的不匹配导致了在滚动后计算鼠标悬停位置时出现偏差，从而显示错误的工具提示。

解决方案

解决此问题需要统一坐标系统的处理方式。正确的做法应该是：

1. 确保所有坐标转换都基于相同的参考系
2. 在计算鼠标悬停位置时考虑滚动偏移量
3. 正确处理不同缩放级别下的坐标转换

影响范围

该问题影响多个Godot版本，包括4.2.2、4.3和4.4等稳定版本。由于PopupMenu是Godot GUI系统中的基础控件，此问题会影响所有使用PopupMenu及其派生控件（如MenuButton）的场景。

开发者建议

对于遇到此问题的开发者，可以采取以下临时解决方案：

1. 尽量减少菜单项数量，避免出现滚动条
2. 自定义PopupMenu子类，重写工具提示显示逻辑
3. 等待官方修复并升级到修复后的版本

总结

Godot引擎中PopupMenu滚动时工具提示显示错误的问题揭示了GUI系统中坐标转换的重要性。正确处理不同层级间的坐标关系是确保UI交互准确性的关键。此问题的修复将提升Godot引擎GUI系统的稳定性和用户体验。