如何为Tkinter CheckboxTreeview的单个节点添加工具提示

我完全懂你遇到的困扰——CheckboxTreeview的节点并不是独立的小部件，没法像Label那样直接给单个节点绑定现成的Tooltip类。不过咱们可以换个思路：通过监听Treeview上的鼠标事件，实时判断当前悬停的是哪个节点，再动态显示对应的提示文本，就能实现单个节点的Tooltip效果啦！

下面是修改后的完整代码，我会在后面解释关键的改动点：

import tkinter as tk
from tkinter import ttk, font
from ttkwidgets import CheckboxTreeview

class CreateToolTip(object):
    def __init__(self, widget, text='tooltip text', wraplength=180):
        self.waittime = 400  # 毫秒
        self.bg = '#fdfde3'
        self.wraplength = wraplength  # 像素
        self.widget = widget
        self.text = text
        # 暂时不绑定Enter/Leave，改为在Treeview全局处理
        self.id = None
        self.tw = None

    def set_text(self, new_text):
        # 新增方法：动态更新tooltip文本
        self.text = new_text

    def enter(self, event=None):
        self.schedule()

    def leave(self, event=None):
        self.unschedule()
        self.hidetip()

    def schedule(self):
        self.unschedule()
        self.id = self.widget.after(self.waittime, lambda: self.showtip(event=None))

    def unschedule(self):
        id = self.id
        self.id = None
        if id:
            self.widget.after_cancel(id)

    def showtip(self, event=None):
        # 调整tooltip位置：优先用鼠标位置，更贴近用户操作
        if event:
            x = event.x_root + 10
            y = event.y_root + 10
        else:
            #  fallback到原逻辑（无event时使用）
            x, y, cx, cy = self.widget.bbox("insert")
            x += self.widget.winfo_rootx()
            y += self.widget.winfo_rooty() + 20
        
        self.tw = tk.Toplevel(self.widget)
        self.tw.wm_overrideredirect(True)
        tk.Label(self.tw, text=self.text, justify='left', background=self.bg,
                 relief='solid', borderwidth=1, wraplength=self.wraplength
                 ).pack(ipadx=10)
        self.tw.wm_geometry(f"+{x}+{y}")

    def hidetip(self):
        tw = self.tw
        self.tw = None
        if tw:
            tw.destroy()


class App():
    def __init__(self, master):  
        self.master = master
        self.master.geometry('300x400')
        self.master.columnconfigure(0, weight=1)
        self.tree = CheckboxTreeview(self.master)
        xsb = ttk.Scrollbar(self.master, orient='horizontal', command=self.tree.xview)
        ysb = ttk.Scrollbar(self.master, orient='vertical', command=self.tree.yview)
        self.tree.configure(yscroll=ysb.set)
        self.tree['columns']=('x', 'y')
        self.tree.column('x', anchor='e', width=40)
        self.tree.column('y', width=40)
        self.tree.heading('#0', text='abc', anchor='w')
        self.tree.heading('x', text='x', anchor='w')
        self.tree.heading('y', text='y', anchor='w')
        self.tree.grid(row=0, column=0)
        ysb.grid(row=0, column=1, sticky='ns')
        xsb.grid(row=1, column=0, sticky='ew')
        self.master.frame = tk.Frame(self.master, highlightbackground="black", highlightthickness=2)
        self.master.frame.grid(row=4, column=0, columnspan=2, sticky='w')
        ref = tk.Label(self.master.frame, text='TEXT', font=tk.font.Font(size=16, weight='bold'))
        ref.grid(row=0, column=0)
        CreateToolTip(ref, text='tooltip')
        
        # 添加测试节点
        ref1 = self.tree.insert('', 'end', text='node 1', values=('x1', 'y1'), open=True)
        ref2 = self.tree.insert('', 'end', text='node 2 - this is a very long text where a tooltip should be displayed', values=('x2', 'y2'), open=True)

        # 初始化Treeview的tooltip
        self.tree_tooltip = CreateToolTip(self.tree, wraplength=200)
        # 获取Treeview的字体，用于测量文本宽度
        self.tree_font = font.Font(font=self.tree.cget("font"))
        # 绑定事件：跟踪鼠标移动、进入、离开
        self.tree.bind('<Motion>', self.on_tree_motion)
        self.tree.bind('<Enter>', self.tree_tooltip.enter)
        self.tree.bind('<Leave>', self.tree_tooltip.leave)
        self.tree.bind('<ButtonPress>', self.tree_tooltip.leave)

    def on_tree_motion(self, event):
        # 获取当前鼠标悬停的节点ID
        current_item = self.tree.identify_row(event.y)
        if current_item:
            # 获取该节点的文本内容
            item_text = self.tree.item(current_item, 'text')
            # 获取#0列的宽度
            col_width = self.tree.column('#0', 'width')
            # 计算文本的实际显示宽度
            text_width = self.tree_font.measure(item_text)
            
            # 只有当文本宽度超过列宽时，才显示tooltip
            if text_width > col_width:
                self.tree_tooltip.set_text(item_text)
                # 重新调度tooltip显示（避免频繁触发）
                self.tree_tooltip.schedule()
                # 传递事件给showtip，用于定位鼠标位置
                self.tree_tooltip.showtip(event)
            else:
                # 文本未超出列宽，隐藏tooltip
                self.tree_tooltip.leave()
        else:
            # 鼠标未悬停在任何节点上，隐藏tooltip
            self.tree_tooltip.leave()

root = tk.Tk()
app = App(root)
app.master.mainloop()

关键改动说明： #

1. 动态更新Tooltip文本：给CreateToolTip新增了set_text方法，能根据当前悬停的节点实时替换提示内容，不再是初始化时固定死的文本。
2. 精准定位悬停节点：通过self.tree.identify_row(event.y)获取鼠标当前所在的节点ID，这是实现单个节点Tooltip的核心——能准确知道用户悬停在哪个节点上。
3. 智能触发逻辑：用self.tree_font.measure(item_text)测量文本的实际显示宽度，和列宽对比后，只有长文本才会触发Tooltip，避免多余的提示干扰。
4. 优化Tooltip位置：把Tooltip的显示位置改成鼠标附近（基于event.x_root和event.y_root），用户体验更自然。
5. 全局事件绑定：把Tooltip的触发事件绑定到整个Treeview上，通过Motion事件跟踪鼠标移动，实时更新节点信息。

这样修改后，当你把鼠标悬停在ref2这个长文本节点上时，就会自动显示对应的Tooltip，短文本节点则不会触发，完全符合你的需求！

备注：内容来源于stack exchange，提问作者bene