如何处理Swing中MouseWheelEvent的两种滚动类型并计算滚动单位数

要从MouseWheelEvent中得到带符号的滚动单位数，核心是根据getScrollType()返回的事件类型，结合其他参数分别处理：

1. 处理WHEEL_UNIT_SCROLL（单位滚动） #

这是最常见的滚动类型，对应鼠标滚轮滚动多行的场景：

• 直接调用getUnitsToScroll()方法即可，它已经返回了带符号的滚动单位数（正数表示向下/向右滚动，负数表示向上/向左滚动）。这个方法内部会自动结合getWheelRotation()和getScrollAmount()，并考虑系统鼠标设置的滚动行数，是官方推荐的方式。
• 也可以手动计算：scrollUnits = e.getWheelRotation() * e.getScrollAmount()，结果和getUnitsToScroll()一致，但前者更简洁。

2. 处理WHEEL_BLOCK_SCROLL（块滚动） #

这种类型对应“滚动一屏”的场景，需要结合目标组件的可见区域来换算成单位数：

• getWheelRotation()的符号决定滚动方向：正数向下/向右，负数向上/向左。
• 块对应的单位数需要根据组件类型计算：比如对于JList或JTextArea，可以用可见区域高度除以行高得到可见行数，以此作为块对应的单位数；如果是通用组件，也可以自定义一个默认的块单位数（比如10）。

完整代码示例 #

public class ScrollWheelHandler implements MouseWheelListener {
    @Override
    public void mouseWheelMoved(MouseWheelEvent e) {
        int scrollUnits = 0;
        Component source = e.getComponent();

        if (e.getScrollType() == MouseWheelEvent.WHEEL_UNIT_SCROLL) {
            // 单位滚动：直接使用系统计算好的单位数
            scrollUnits = e.getUnitsToScroll();
        } else if (e.getScrollType() == MouseWheelEvent.WHEEL_BLOCK_SCROLL) {
            // 块滚动：根据组件类型换算单位数
            if (source instanceof JScrollPane) {
                JScrollPane scrollPane = (JScrollPane) source;
                JViewport viewport = scrollPane.getViewport();
                Component content = viewport.getView();

                if (content instanceof JList<?>) {
                    JList<?> list = (JList<?>) content;
                    int rowHeight = list.getFixedCellHeight() > 0 
                        ? list.getFixedCellHeight() 
                        : list.getPreferredSize().height / list.getModel().getSize();
                    int visibleRows = viewport.getHeight() / rowHeight;
                    scrollUnits = e.getWheelRotation() * visibleRows;
                } else if (content instanceof JTextArea) {
                    JTextArea textArea = (JTextArea) content;
                    FontMetrics metrics = textArea.getFontMetrics(textArea.getFont());
                    int rowHeight = metrics.getHeight();
                    int visibleRows = viewport.getHeight() / rowHeight;
                    scrollUnits = e.getWheelRotation() * visibleRows;
                }
                // 可扩展支持其他组件（如JTable、JTree等）
            } else {
                // 非滚动面板组件，使用默认块单位数
                scrollUnits = e.getWheelRotation() * 10;
            }
        }

        // 示例：将计算出的单位数应用到滚动面板
        if (source instanceof JScrollPane) {
            JScrollPane scrollPane = (JScrollPane) source;
            JScrollBar verticalBar = scrollPane.getVerticalScrollBar();
            verticalBar.setValue(verticalBar.getValue() + scrollUnits * verticalBar.getUnitIncrement(1));
        }
    }
}

关于WHEEL_BLOCK_SCROLL的额外说明 #

• 触发场景：目前普遍推测在Windows系统中，当鼠标设置选择“每次滚动一个屏幕”而非“每次滚动多行”时会触发该事件，但该推测尚未完全验证，也没有官方明确说明。
• 文档缺失问题：Oracle官方文档仅定义了WHEEL_BLOCK_SCROLL常量，但未解释其作用和处理逻辑；官方鼠标滚轮监听器教程也仅演示了如何打印该类型名称，未给出实际处理方案。
• 现有参考情况：少数开源项目中曾有处理该事件的代码，但已被注释，无法确认其有效性。

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