使用Component Adapter后垂直滚动条失效，该如何解决？

我正在用Java开发一款独立处方书写软件，程序已经接近可用状态，但有些细节还不满意。我采用了多层基于GridBagLayout布局的面板，发现将窗口调整至较小尺寸时会出现水平滚动条，希望能换一种方式调整内容尺寸，仅保留垂直滚动条即可满足需求。我尝试使用Component Adapter调整内容尺寸，虽然成功调整了内容大小，但垂直滚动条却无法正常工作。我编写了一个小型测试程序来复现该问题，解决此问题后便可将方案应用到原大型程序中。

import java.awt.event.ComponentEvent;
import java.awt.event.ComponentAdapter;
import java.awt.*;
import javax.swing.*;

public class Test {
    
    static JFrame f=new JFrame("The Test");
    static GridBagLayout gridbag = new GridBagLayout();
    static GridBagConstraints c = new GridBagConstraints();
    static JPanel panel = new JPanel(gridbag);
    static JPanel panel1 = new JPanel();
    static JPanel panel2 = new JPanel();
    static JPanel panel3 = new JPanel();
    static JTextArea ta1 = new JTextArea("");
    static JTextArea ta2 = new JTextArea("");
    
    public static void main(String[] args) {
        c.fill = GridBagConstraints.BOTH;
        c.gridx = 0;      
        c.gridy = 0;
        c.weightx = 1.0;
        c.weighty = 0.0;
        c.gridwidth = 2;
        c.gridheight = 1;
        gridbag.setConstraints(panel1, c);
        panel.add(panel1);
        panel1.add(new JLabel("To check the resize behavior..."));

        String s = "This is such a beautiful day... ";
        s = s + s + s + s + s + s + s + s;
        s = s + s + s + s + s + s + s + s;
        s = s + s + s + s + s + s + s + s;
        ta1.setText(s);
        ta1.setWrapStyleWord(true);
        ta1.setLineWrap(true);
        panel2.setLayout(new BorderLayout());
        panel2.add(ta1);
        JScrollPane scrPane1 = new JScrollPane(panel2);
        scrPane1.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_ALWAYS);
        scrPane1.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_AS_NEEDED);
        c.gridy = 1;
        c.weightx = 0.5;
        c.weighty = 1.0;
        c.gridwidth = 1;
        gridbag.setConstraints(scrPane1, c);
        panel.add(scrPane1);
        
        s = "Lets enjoy our day... ";
        s = s + s + s + s + s + s + s + s;
        s = s + s + s + s + s + s + s + s;
        s = s + s + s + s + s + s + s + s;
        ta2.setText(s);
        ta2.setWrapStyleWord(true);
        ta2.setLineWrap(true);
        panel3.setLayout(new GridLayout());
        panel3.add(ta2);
        JScrollPane scrPane2 = new JScrollPane(panel3);
        scrPane2.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_ALWAYS);
        scrPane2.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_NEVER);
        c.gridx = 1;  
        gridbag.setConstraints(scrPane2, c);
        panel.add(scrPane2);
        
        f.add(panel);
        f.setSize(1000,500);  
        f.setVisible(true);
        f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        
        f.addComponentListener(new ComponentAdapter() {
            @Override
            public void componentResized(ComponentEvent e) {
                Dimension d = new Dimension((int)panel.getSize().getWidth()/2 -JScrollBar.WIDTH-20, (int)panel.getSize().getHeight());
                panel2.setPreferredSize(d);
                panel3.setPreferredSize(d);
                f.repaint();
            }
        });//*/
    }
}

问题根源 #

手动设置panel2和panel3的preferredSize会干扰JScrollPane的布局逻辑，导致它无法正确计算文本区域的滚动需求。此外，手动计算宽度完全没必要，GridBagLayout本身就支持均分空间，配合文本区域和滚动面板的正确配置就能避免水平滚动条。

修复步骤 #

1. 移除ComponentListener：无需手动监听窗口大小变化来设置组件尺寸，让布局管理器自动处理空间分配。
2. 优化文本区域配置：给JTextArea设置初始行列数，提供合理的首选尺寸，同时保持自动换行属性。
3. 简化布局层级：去掉文本区域外多余的中间JPanel，直接用JScrollPane包裹JTextArea，让滚动逻辑更清晰。
4. 禁用水平滚动条：明确设置滚动面板的水平滚动条为HORIZONTAL_SCROLLBAR_NEVER，配合文本区域的自动换行彻底消除水平滚动条。

修复后的代码 #

import java.awt.*;
import javax.swing.*;

public class Test {
    
    static JFrame f = new JFrame("The Test");
    static GridBagLayout gridbag = new GridBagLayout();
    static GridBagConstraints c = new GridBagConstraints();
    static JPanel panel = new JPanel(gridbag);
    static JPanel panel1 = new JPanel();
    static JTextArea ta1 = new JTextArea(10, 30); // 设置初始行列数，定义首选尺寸
    static JTextArea ta2 = new JTextArea(10, 30);
    
    public static void main(String[] args) {
        // 顶部标签面板配置
        c.fill = GridBagConstraints.BOTH;
        c.gridx = 0;      
        c.gridy = 0;
        c.weightx = 1.0;
        c.weighty = 0.0;
        c.gridwidth = 2;
        c.gridheight = 1;
        gridbag.setConstraints(panel1, c);
        panel.add(panel1);
        panel1.add(new JLabel("To check the resize behavior..."));

        // 左侧文本区域与滚动面板
        String s = "This is such a beautiful day... ";
        s = s.repeat(24); // 简化字符串重复逻辑
        ta1.setText(s);
        ta1.setWrapStyleWord(true);
        ta1.setLineWrap(true);
        ta1.setBorder(BorderFactory.createEmptyBorder(5,5,5,5)); // 添加内边距提升美观度
        JScrollPane scrPane1 = new JScrollPane(ta1);
        scrPane1.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
        scrPane1.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_NEVER);
        c.gridy = 1;
        c.weightx = 0.5;
        c.weighty = 1.0;
        c.gridwidth = 1;
        gridbag.setConstraints(scrPane1, c);
        panel.add(scrPane1);
        
        // 右侧文本区域与滚动面板
        s = "Lets enjoy our day... ";
        s = s.repeat(24);
        ta2.setText(s);
        ta2.setWrapStyleWord(true);
        ta2.setLineWrap(true);
        ta2.setBorder(BorderFactory.createEmptyBorder(5,5,5,5));
        JScrollPane scrPane2 = new JScrollPane(ta2);
        scrPane2.setVerticalScrollBarPolicy(JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED);
        scrPane2.setHorizontalScrollBarPolicy(JScrollPane.HORIZONTAL_SCROLLBAR_NEVER);
        c.gridx = 1;  
        gridbag.setConstraints(scrPane2, c);
        panel.add(scrPane2);
        
        f.add(panel);
        f.setSize(1000, 500);  
        f.setVisible(true);
        f.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
    }
}

关键说明 #

• GridBagLayout的weightx=0.5让两个滚动面板自动均分水平空间，fill=BOTH确保组件填充分配到的区域，窗口调整时自动缩放。
• 文本区域的自动换行属性配合滚动面板禁用水平滚动条，确保内容始终在宽度范围内换行，不会触发水平滚动。
• 去掉中间JPanel后，JScrollPane能直接感知文本区域的尺寸变化，正确计算垂直滚动需求，滚动条可正常工作。

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