Java Swing 滚动面板 JScrollPane 使用示例

Java Swing 滚动面板 JScrollPane 实战

在 Swing 桌面应用开发里，遇到长文本或大表格时，直接塞进窗口肯定不行。这时候 JScrollPane 就是标准解决方案。它能把任意组件包装起来，自动处理超出可视区域的部分。

下面这段代码演示了如何结合 JTextArea 创建一个带滚动功能的文本显示区。

public static void main(String[] args) {
    JFrame jf = new JFrame();
    jf.setSize(400, 300);
    jf.setLocationRelativeTo(null);
    jf.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);

    // 创建文本区域
    JTextArea textArea = new JTextArea();
    textArea.setLineWrap(true); // 开启自动换行
    textArea.setFont(new Font("楷体", Font.PLAIN, 22));
    textArea.setForeground(Color.blue); // 设置文字颜色

    // 创建滚动面板，指定显示组件
    JScrollPane scrollPane = new JScrollPane(textArea,
            ScrollPaneConstants.VERTICAL_SCROLLBAR_ALWAYS, // 垂直滚动条始终显示
            ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED // 水平滚动条按需显示
    );

    jf.setContentPane(scrollPane);
    jf.setVisible(true);
}

这里有几个细节值得注意。首先是 JTextArea 的配置，setLineWrap(true) 能让长单词自动折行，避免水平滚动条频繁出现。字体和颜色的设置是为了提升可读性。

关键在于 JScrollPane 的构造函数。第一个参数是视口视图（也就是我们要滚动的组件），后面两个参数分别控制垂直和水平滚动条的策略。比如这里垂直方向设为 ALWAYS，意味着即使内容不多也会预留滚动条空间；而水平方向设为 AS_NEEDED，只有在内容宽度超过容器时才会出现滚动条。

最后通过 jf.setContentPane() 将滚动面板挂载到窗口上，调用 setVisible(true) 即可运行。实际使用时，往 textArea 里填充大量文本，就能直观看到滚动效果了。