Python GTK3 如何为DrawingArea上的不同图形分别显示工具提示

针对Python 3.7 + GTK3开发环境，你提到的两种思路（监听鼠标位置、图形命中检测）是完全可行的原生实现路径，不需要依赖第三方扩展，具体实现逻辑和代码如下：

核心实现逻辑 #

整个方案分为三个核心环节：

• 持久化存储绘制图形的参数：不能在draw回调里画完矩形就丢弃坐标信息，需要把每个矩形的位置、尺寸、对应Tooltip文本统一存储在可访问的成员变量中，为后续命中检测提供判断依据
• 绑定DrawingArea的鼠标事件：开启鼠标移动、组件离开的事件监听，实时获取鼠标在组件上的相对坐标
• 实时执行命中检测：鼠标位置变动时，遍历所有已存储的图形参数，判断当前坐标是否落在对应图形的范围内，根据命中结果动态更新DrawingArea的Tooltip文本，鼠标不在任何图形上时清空Tooltip

可直接运行的示例代码 #

import gi
gi.require_version('Gtk', '3.0')
from gi.repository import Gtk, Gdk

class RectTooltipDrawingArea(Gtk.DrawingArea):
    def __init__(self):
        super().__init__()
        # 存储两个矩形的参数与对应Tooltip
        self.rect_elements = [
            {"x": 50, "y": 50, "width": 100, "height": 80, "tooltip": "Tooltip1: Rectangle1"},
            {"x": 200, "y": 50, "width": 100, "height": 80, "tooltip": "Tooltip2: Rectangle2"}
        ]
        # 注册需要监听的事件掩码
        self.add_events(Gdk.EventMask.POINTER_MOTION_MASK | Gdk.EventMask.LEAVE_NOTIFY_MASK)
        # 绑定信号回调
        self.connect("draw", self._draw_rects)
        self.connect("motion-notify-event", self._update_tooltip_on_move)
        self.connect("leave-notify-event", self._clear_tooltip_on_leave)

    def _draw_rects(self, widget, cairo_context):
        # 按照存储的参数绘制两个矩形
        for rect in self.rect_elements:
            cairo_context.rectangle(
                rect["x"], rect["y"],
                rect["width"], rect["height"]
            )
            cairo_context.stroke()

    def _update_tooltip_on_move(self, widget, event):
        # 获取鼠标相对DrawingArea的坐标
        pos_x, pos_y = event.x, event.y
        match_tip = ""
        # 逐元素做矩形范围命中判断
        for rect in self.rect_elements:
            is_in_x_range = rect["x"] <= pos_x <= rect["x"] + rect["width"]
            is_in_y_range = rect["y"] <= pos_y <= rect["y"] + rect["height"]
            if is_in_x_range and is_in_y_range:
                match_tip = rect["tooltip"]
                break
        # 动态更新Tooltip
        widget.set_tooltip_text(match_tip)

    def _clear_tooltip_on_leave(self, widget, event):
        # 鼠标移出DrawingArea时清空Tooltip
        widget.set_tooltip_text("")

# 测试入口
if __name__ == "__main__":
    window = Gtk.Window()
    window.connect("destroy", Gtk.main_quit)
    drawing_area = RectTooltipDrawingArea()
    drawing_area.set_size_request(350, 200)
    window.add(drawing_area)
    window.show_all()
    Gtk.main()

补充注意事项 #

• 该实现完全使用GTK3原生API，不存在Python 3.7的版本兼容问题，复用系统原生Tooltip渲染逻辑，样式和全局控件保持统一
• 后续如果扩展非矩形图形（圆形、不规则路径等），只需要替换命中检测中的判断逻辑，整体框架无需改动
• 不需要手动实现Tooltip浮层的绘制、位置偏移、自动隐藏逻辑，大幅降低开发复杂度

内容的提问来源于stack exchange，提问作者demirod