Windows用WM_MOUSEWHEEL捕获滚轮消息，需在WndProc中处理，wParam高16位为增量，lParam含坐标；Qt应重写wheelEvent并调用accept()；GLFW需提前注册scroll_callback且注意yoffset符号；SDL2跨平台行为不一致，建议抽象标准化delta Y。
Windows平台用WM_MOUSEWHEEL捕获滚轮消息
在Win32 API中，鼠标滚轮事件不是通过普通鼠标移动或按键消息触发的，而是专用的WM_MOUSEWHEEL消息。它只在窗口拥有焦点且鼠标悬停在其客户区时被投递。
常见错误是试图用WM_MOUSEMOVE或GetAsyncKeyState监听滚轮——这些根本收不到滚轮数据。
-
wParam高16位包含滚轮增量（GET_WHEEL_DELTA_WPARAM(wParam)），标准值为WHEEL_DELTA（120），向上滚动为正，向下为负 -
lParam低16位是X坐标，高16位是Y坐标（需用GET_X_LPARAM(lParam)/GET_Y_LPARAM(lParam)提取） - 必须在窗口过程函数（
WndProc）里显式处理该消息，返回0表示已处理；不处理则默认调用DefWindowProc
Qt中重写wheelEvent比信号更可靠
Qt的QWheelEvent对象封装了滚轮方向、角度和像素精度，但直接连接wheel信号容易漏事件——尤其当控件没获得焦点或被父控件拦截时。
真正稳定的做法是继承目标控件类（如QWidget或QGraphicsView），重写wheelEvent虚函数：
立即学习“C++免费学习笔记（深入）”；
void MyWidget::wheelEvent(QWheelEvent *event) {
if (event->angleDelta().y() > 0) {
// 向上滚动
} else {
// 向下滚动
}
event->accept(); // 关键：不调用父类实现，避免重复触发
}
-
event->angleDelta()返回QPoint，Y分量代表垂直滚轮偏移（单位是“八分之一度”，通常±120表示一次刻度） -
event->pixelDelta()在高DPI或触控板场景下更准，但Windows传统鼠标主要靠angleDelta - 务必调用
event->accept()，否则事件会继续向上传递，可能触发父控件的相同逻辑
GLFW里scroll_callback要提前注册且注意坐标系
GLFW不区分窗口焦点，默认全局监听滚轮。但回调函数注册必须在创建窗口后、进入主循环前完成，否则事件直接丢弃。
典型陷阱是把回调绑在子线程或延迟初始化之后——glfwSetScrollCallback只对当前绑定的窗口生效，且不可叠加。
- 回调原型：
void scroll_callback(GLFWwindow*, double xoffset, double yoffset) -
yoffset正值表示向上滚动（与Win32相反），多数UI库采用此约定，但OpenGL渲染时需注意是否要反转Y轴 - 若用多个窗口，需为每个窗口单独设置回调，并在回调内用
glfwGetWindowUserPointer区分上下文 - 滚动速度受系统设置影响（如Windows“每次滚动几行”），GLFW不缩放该值，应用层需自行做平滑或阈值过滤
跨平台方案慎用SDL2的SDL_MOUSEWHEEL
SDL2的SDL_MOUSEWHEEL事件看似统一，但底层行为差异大：Windows走WM_MOUSEWHEEL，macOS走NSEventTypeScroll，Linux X11依赖XInput2扩展支持。实际使用中容易出现：
- Wayland会话下滚轮事件丢失（SDL2 2.0.22之前无原生支持）
- macOS触控板惯性滚动产生大量微小
remainder字段值，需累积判断有效滚动 -
event.wheel.y在不同平台符号不一致（macOS向上为负），建议统一用event.wheel.direction == SDL_MOUSEWHEEL_NORMAL判别
如果项目必须跨三端，优先考虑抽象一层事件分发器，把原始滚轮数据转成标准化的“delta Y”再交给业务逻辑，而不是直接依赖SDL2字段。
