Tkinter：防止触控板水平滚轮影响垂直滚动

问题根源 #

Mac平台下，<MouseWheel>事件（包括触控板滚动）会同时携带水平和垂直方向的滚动数据——哪怕你只是做水平滑动操作，也可能因为手势的细微偏差产生微小的垂直delta值，原代码如果未过滤这部分输入，就会触发画布的垂直滚动，导致顶部/底部位置的抖动。

解决办法 #

核心思路是在滚轮事件处理函数中仅响应垂直方向的滚动输入，直接忽略水平分量，同时优化事件绑定范围，避免无关区域触发无效滚动。

1. 修改滚轮事件处理逻辑

在你的VerticalScrolledFrame类中，调整_on_mousewheel函数，添加水平滚动的过滤判断：

import sys
import tkinter as tk

class VerticalScrolledFrame(tk.Frame):
    def __init__(self, parent, *args, **kw):
        super().__init__(parent, *args, **kw)
        # 原有的初始化代码（创建画布、滚动条、内部框架）
        self.canvas = tk.Canvas(self, borderwidth=0, highlightthickness=0)
        self.scrollbar = tk.Scrollbar(self, orient="vertical", command=self.canvas.yview)
        self.interior = tk.Frame(self.canvas)
        
        self.interior.bind("<Configure>", self._configure_interior)
        self.canvas.configure(yscrollcommand=self.scrollbar.set)
        self.scrollbar.pack(side="right", fill="y")
        self.canvas.pack(side="left", fill="both", expand=True)
        self.canvas.create_window((0, 0), window=self.interior, anchor="nw")
        
        # 绑定滚轮事件到画布和内部框架
        self.canvas.bind("<MouseWheel>", self._on_mousewheel)
        self.interior.bind("<MouseWheel>", self._on_mousewheel)

    def _configure_interior(self, event):
        self.canvas.configure(scrollregion=self.canvas.bbox("all"))

    def _on_mousewheel(self, event):
        # 过滤水平滚动事件
        # 适配tkinter 8.6+的delta_y属性（直接获取垂直滚动量）
        if hasattr(event, 'delta_y'):
            delta = event.delta_y
        else:
            # 兼容旧版本：Mac上垂直滚动delta为±120，水平为±1
            if abs(event.delta) != 120:
                # 判定为水平滚动，直接返回不处理
                return
            delta = event.delta
        
        # 多平台滚轮速度适配
        if sys.platform == 'darwin':
            delta *= 2  # Mac默认滚轮速度偏慢，可根据需求调整倍数
        
        # 仅执行垂直滚动
        self.canvas.yview_scroll(int(-1 * (delta / 120)), "units")
        # 阻止事件向上传播，避免父组件触发不必要的滚动
        return "break"

2. 优化事件绑定范围

将滚轮事件同时绑定到画布和内部嵌套的interior框架上，确保只有在内容区域滚动才触发；同时在处理函数末尾返回"break"，阻止事件向上冒泡到父容器，避免其他组件误触发滚动。

3. 额外的Mac平台适配

如果使用触控板，可根据系统“滚动方向：自然”的设置调整delta的正负值，比如系统开启自然滚动时，将delta = -delta，但代码层面的水平滚动过滤已经能解决核心抖动问题。

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