Java Swing JFrame使用ScrollPane时高度超出屏幕的问题如何解决

问题根因 #

你调用frame.pack()方法时，Swing默认会按照内部组件的首选大小计算窗口总尺寸，当ScrollPane内的内容高度远超过屏幕高度时，pack计算出的窗口高度会直接超出屏幕可用范围，导致出现你遇到的高度溢出问题。

另外你之前尝试的frame.setExtendedState(JFrame.MAXIMIZED_VERT)无效，是因为不同桌面平台对该属性的实现兼容度有限，部分平台要求窗口完全可见后才能生效，且该属性会强制垂直方向拉满，就算内容高度很小的时候也会占满垂直空间，不符合自适应需求。

修复方案 #

在pack计算原始尺寸后，主动判断窗口高度是否超出系统可用的窗口最大高度（自动排除任务栏、系统菜单栏等占位区域，比直接读取屏幕总高度更准确），如果超出则手动限制窗口高度为系统可用最大值，宽度保持pack计算出的原始值，不会触发横向最大化，符合你的需求。

修改后的完整代码 #

import java.awt.GraphicsEnvironment;
import java.awt.Rectangle;
import java.awt.Toolkit;
import javax.swing.BoxLayout;
import javax.swing.JFrame;
import javax.swing.JLabel;
import javax.swing.JPanel;
import javax.swing.JScrollPane;
import javax.swing.ScrollPaneConstants;

public class tests
{
    public static void main(String[] args)
    {
        JFrame frame = new JFrame();
        frame.setLayout(new BoxLayout(frame.getContentPane(), BoxLayout.Y_AXIS) );
        
        JPanel panel = new JPanel();
        panel.setLayout(new BoxLayout(panel, BoxLayout.Y_AXIS) );
        
        for (int i = 0; i < 100; i ++)
            panel.add(new JLabel("Label") );
        
        JScrollPane scroll_pane = new JScrollPane(panel,
            ScrollPaneConstants.VERTICAL_SCROLLBAR_AS_NEEDED,
            ScrollPaneConstants.HORIZONTAL_SCROLLBAR_AS_NEEDED);
        
        frame.add(scroll_pane);
        frame.pack();

        // 新增高度限制逻辑
        GraphicsEnvironment ge = GraphicsEnvironment.getLocalGraphicsEnvironment();
        Rectangle usableWindowBounds = ge.getMaximumWindowBounds();
        int maxAllowedHeight = usableWindowBounds.height;
        // 仅限制高度，保持原有计算出的宽度不变
        if (frame.getHeight() > maxAllowedHeight) {
            frame.setSize(frame.getWidth(), maxAllowedHeight);
        }

        frame.setVisible(true);
        frame.setDefaultCloseOperation(JFrame.DISPOSE_ON_CLOSE);
        
        System.out.println(Toolkit.getDefaultToolkit().getScreenSize().getHeight() );
        System.out.println(frame.getHeight() );
    }
}

关键逻辑说明 #

• GraphicsEnvironment.getMaximumWindowBounds()返回的是当前系统中窗口可以占用的最大区域，已经自动扣除了任务栏、Mac顶部菜单栏、Dock等系统组件的占位，比直接用Toolkit.getScreenSize()的高度更准确，不会出现窗口底部被任务栏遮挡的问题。
• 仅在内容高度超过可用高度时才限制窗口高度，如果内容高度小于可用高度，窗口会保持内容本身的高度，不会强制拉满。
• 全程不修改窗口宽度，符合你不希望横向占满屏幕的需求。

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