如何实现鼠标滚轮在Text组件上时同步滚动两个Tkinter Text控件？

问题说明 #

用Tkinter实现带行号的文本输入框后，通过滚动条可同步滚动文本框和行号框，但鼠标悬停在文本区域滚动滚轮时，只有文本框滚动，行号框无响应。尝试给文本框绑定<MouseWheel>事件调用同步函数时，触发报错：

_tkinter.TclError: bad text index "<MouseWheel event send_event=True state=Mod1 delta=120 x=324 y=163>"

错误原因 #

原multiple_yview函数是为滚动条的command参数设计的，接收('scroll', 数量, 'units')或('moveto', 比例)这类格式的参数。但绑定鼠标滚轮事件时，传入的是鼠标事件对象，直接把事件对象传给yview方法，会被当成文本索引解析，导致格式错误。

解决方法 #

修改同步函数，区分两种调用场景：

1. 若参数是鼠标事件对象：解析滚轮的delta值，转换成yview需要的滚动指令，同步滚动两个文本框。
2. 若参数是滚动条的标准指令：直接传递给两个文本框的yview方法。

同时注意不同系统的滚轮delta值差异：Windows系统滚轮滚动一次delta为±120，Mac系统为±1，需统一转换成滚动单位。

修改后的完整代码 #

import tkinter as tk

def multiple_yview(*args):
    # 处理鼠标滚轮事件
    if len(args) == 1 and isinstance(args[0], tk.Event):
        event = args[0]
        # 计算滚动方向和步数，适配不同系统的delta值
        delta = event.delta
        step = -1 if delta > 0 else 1
        # 同步滚动两个文本框
        text.yview_scroll(step, "units")
        line_numbers.yview_scroll(step, "units")
    # 处理滚动条的指令
    else:
        text.yview(*args)
        line_numbers.yview(*args)

root = tk.Tk()
text_frame = tk.Frame(root)
scrollbar = tk.Scrollbar(text_frame)
line_numbers = tk.Text(text_frame, width=9, state="disabled", bd=0, bg="#F0F0F0")
text = tk.Text(text_frame, yscrollcommand=scrollbar.set, wrap="none")

# 绑定鼠标滚轮事件
text.bind('<MouseWheel>', multiple_yview)
# 可选：绑定行号框的滚轮事件，用户悬停在行号区域时也能同步滚动
line_numbers.bind('<MouseWheel>', multiple_yview)

scrollbar.config(command=multiple_yview)

# 填充测试内容和行号
for i in range(0, 100):
    text.insert("end", f"A{i}\n")
    line_numbers.configure(state="normal")
    line_numbers.insert("end", f"{i}) \n")
    line_numbers.configure(state="disabled")

text_frame.grid(row=0, column=0)
line_numbers.grid(row=0, column=0)
text.grid(row=0, column=1)
scrollbar.grid(row=0, column=2, sticky=tk.N + tk.S)

root.mainloop()

关键修改点 #

• 函数内增加参数类型判断，区分事件对象和滚动条指令。
• 使用yview_scroll方法处理滚轮事件，避免直接传递事件对象导致格式错误。
• 可选绑定行号框的滚轮事件，覆盖更多用户操作场景。

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