本文介绍了在使用 Kivy 开发桌面应用时，collide_point() 方法在检测鼠标悬停事件时可能遇到的问题，即在非 100% 显示缩放比例下，Window.mouse_pos 返回的坐标未考虑显示密度，导致检测不准确。通过引入 kivy.metrics.Metrics.density 修正鼠标位置，可以有效解决此问题，从而准确实现鼠标悬停效果。
Kivy 提供了 collide_point() 方法来检测坐标是否位于组件内部，这对于实现鼠标悬停效果至关重要。然而，在桌面应用开发中，尤其是在 windows 等操作系统上，用户可能设置了非 100% 的显示缩放比例（例如 125%、150%）。在这种情况下，Window.mouse_pos 返回的鼠标坐标可能与组件的实际位置不匹配，导致 collide_point() 误判。
问题根源：显示密度与坐标转换
问题的核心在于 Window.mouse_pos 返回的坐标是基于未缩放的像素坐标，而组件的位置和大小是基于缩放后的坐标。因此，需要将鼠标坐标转换为与组件相同的坐标系。
解决方案：使用 Metrics.density 修正鼠标位置
Kivy 提供了 kivy.metrics.Metrics.density 属性，用于获取当前的显示密度。通过将 Window.mouse_pos 返回的 x 和 y 坐标乘以 Metrics.density，可以将鼠标坐标转换为与组件相同的坐标系。
以下是修正后的代码示例：
from kivy.app import App from kivy.uix.button import Button from kivy.graphics import Color, Rectangle from kivy.core.window import Window from kivy.uix.floatlayout import FloatLayout from kivy.metrics import Metrics # 导入 Metrics 以访问显示密度 class HoverButton(Button): def __init__(self, **kwargs): super(HoverButton, self).__init__(**kwargs) Window.bind(mouse_pos=self.check_for_hover) def check_for_hover(self, *args): mouse_pos = args[1] new_x = mouse_pos[0] * Metrics.density # 将 mouse_pos 乘以密度 new_y = mouse_pos[1] * Metrics.density new_mouse_pos = (new_x, new_y) if self.collide_point(*new_mouse_pos): print('cursor inside widget') self.text = 'cursor inside' else: print('cursor outside widget') self.text = 'cursor outside' class Frame(FloatLayout): def __init__(self, **kwargs): super(Frame, self).__init__(**kwargs) class HoverApp(App): def build(self): return Frame() if __name__ == '__main__': HoverApp().run()
在这个示例中，我们在 check_for_hover 方法中，首先获取 Window.mouse_pos 返回的鼠标坐标，然后将其 x 和 y 坐标分别乘以 Metrics.density，得到修正后的鼠标坐标 new_mouse_pos。最后，使用修正后的坐标调用 collide_point() 方法，即可准确检测鼠标是否悬停在组件上。
注意事项：
- 此问题主要影响 Kivy 桌面应用程序，尤其是当用户使用非 100% 的显示缩放比例时。
- 如果你的应用程序需要在不同的显示密度下正常工作，建议始终使用 Metrics.density 修正鼠标坐标。
- 除了鼠标位置，有时还需要注意画布绘制的 pos 或 points 属性，在不同密度下可能也需要乘以密度值。
总结：
通过使用 kivy.metrics.Metrics.density 修正 Window.mouse_pos 返回的鼠标坐标，可以有效解决 Kivy collide_point() 方法在非 100% 显示缩放比例下出现偏差的问题，从而准确实现鼠标悬停效果。 记住，在开发桌面 Kivy 应用时，考虑到显示密度是一个重要的环节，可以避免很多潜在的显示问题。
