Java JTree设置自定义BasicTreeUI后滚动条失效问题咨询

问题现象 #

• 未设置自定义TreeUI时，JTree嵌入JScrollPane的垂直滚动条可正常按需显隐：面板空间充足时滚动条隐藏，拖拽压缩树组件展示空间到足够小时，垂直滚动条自动出现
• 添加tree.setUI(new MyTreeUI())代码后，无论怎么压缩面板空间，垂直滚动条都无法显示，注释该行后垂直滚动条行为恢复正常
• 即便不使用自定义UI，JTree的水平滚动条始终不会自动出现
• 可复现问题的核心代码片段：

tree = new JTree(top);
tree.setUI(new MyTreeUI());  // 注释该行后垂直滚动条恢复正常

// 自定义UI实现
private static class MyTreeUI extends BasicTreeUI 
{
    public MyTreeUI() {
        super();
    }

    @Override
    protected void updateCachedPreferredSize() {
        treeState.invalidateSizes();
        tree.treeDidChange();
    }
}

问题1：继承BasicTreeUI实现自定义UI时，如何保证JScrollPane滚动条正常工作 #

根本原因 #

自定义UI中重写的updateCachedPreferredSize()方法丢失了父类的核心计算逻辑。BasicTreeUI的updateCachedPreferredSize()方法负责计算并缓存树组件的完整首选尺寸，JScrollPane正是通过对比组件首选尺寸和当前视口尺寸的差值，判断是否需要显示滚动条。该方法被覆写后没有调用父类实现，仅执行了尺寸失效和变更通知，导致UI层始终返回错误的首选尺寸值，JScrollPane判定树内容高度永远小于视口高度，自然不会触发垂直滚动条显示。

正确配置要求 #

• 非必要不随意重写BasicTreeUI中负责尺寸计算的内部方法（包括updateCachedPreferredSize()、getPreferredSize()相关逻辑）；如果必须重写，必须先调用super.updateCachedPreferredSize()完成父类的默认计算逻辑，再追加自定义处理，不能直接替换原有实现。
• 自定义UI开发完成后，需要校验树组件的getPreferredSize()、getPreferredScrollableViewportSize()返回值是否和实际渲染内容的尺寸匹配，这两个值是JScrollPane滚动条显隐判断的核心依据。
• 如果自定义了节点渲染器，需要同步校验getRowBounds()等返回节点位置、尺寸的方法结果是否准确，避免整个尺寸计算链路出错。

修正后的自定义UI示例 #

private static class MyTreeUI extends BasicTreeUI 
{
    @Override
    protected void updateCachedPreferredSize() {
        // 必须先调用父类实现，完成首选尺寸的计算与缓存
        super.updateCachedPreferredSize();
        // 追加自定义逻辑
        treeState.invalidateSizes();
        tree.treeDidChange();
    }
}

问题2：未使用自定义UI时，JTree水平滚动条始终不显示的原因 #

根本原因 #

JTree默认的getPreferredScrollableViewportSize()方法实现不会主动返回所有节点的完整宽度，默认返回的宽度值始终适配当前视口宽度，JScrollPane会判定内容宽度永远不会超出视口范围，因此不会触发水平滚动条显示。

修复方案 #

重写JTree的getPreferredScrollableViewportSize()方法，让其返回树组件实际计算的完整首选尺寸即可，示例代码：

tree = new JTree(top) {
    @Override
    public Dimension getPreferredScrollableViewportSize() {
        return getPreferredSize();
    }
};

加上这段代码后，当树节点宽度超出视口宽度时，水平滚动条就会自动出现。

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