如何在JFrame缩放时实现JScrollPane内图片的自适应调整

问题概述 #

• 开发基于JFrame的图片画廊，需支持滚动、双击全屏功能
• 当前存在两个核心问题：
  • 缩放窗口时图片因无水平滚动条被截断，需保留垂直滚动的同时让面板水平适配窗口宽度
  • 使用StretchIcon实现图片动态缩放后，图片间出现过大间距

解决思路与代码实现 #

1. 实现水平适配+垂直滚动 #

通过监听JScrollPane视口尺寸变化，动态调整图片面板的首选大小，确保面板宽度始终匹配视口，高度根据图片数量自适应：

try {
    BufferedImage image = ImageIO.read(new File("myFile.png"));
    
    // 自定义图片面板，重写首选尺寸计算逻辑
    JPanel imagePanel = new JPanel() {
        @Override
        public Dimension getPreferredSize() {
            if (getParent() instanceof JViewport viewport) {
                int viewportWidth = viewport.getWidth();
                if (viewportWidth > 0) {
                    // 计算单张图片宽度：视口宽度减去列间距，平分给2列
                    int singleImgWidth = (viewportWidth - 5) / 2;
                    // 按原图比例计算图片高度，避免拉伸变形
                    int singleImgHeight = (int) (image.getHeight() * (double) singleImgWidth / image.getWidth());
                    // 总高度：4行图片高度 + 3个垂直间距（8张图分4行）
                    int totalHeight = 4 * singleImgHeight + 3 * 5;
                    return new Dimension(viewportWidth, totalHeight);
                }
            }
            return super.getPreferredSize();
        }
    };
    imagePanel.setLayout(new GridLayout(0, 2, 5, 5));
    
    // 批量添加带缩放功能的图片标签
    for (int x = 0; x < 8; ++x) {
        JLabel imgLabel = new JLabel();
        // 使用StretchIcon实现等比例缩放
        StretchIcon stretchIcon = new StretchIcon(image, StretchIcon.STRETCH_UNIFORM);
        imgLabel.setIcon(stretchIcon);
        // 让图片居中填充标签，避免留白导致的间距错觉
        imgLabel.setHorizontalAlignment(JLabel.CENTER);
        imgLabel.setVerticalAlignment(JLabel.CENTER);
        imagePanel.add(imgLabel);
    }
    
    // 配置滚动面板：仅保留垂直滚动
    JScrollPane scrollPane = new JScrollPane(imagePanel,
            JScrollPane.VERTICAL_SCROLLBAR_AS_NEEDED,
            JScrollPane.HORIZONTAL_SCROLLBAR_NEVER);
    
    // 监听视口尺寸变化，触发面板重新布局
    scrollPane.getViewport().addChangeListener(e -> {
        imagePanel.revalidate();
        imagePanel.repaint();
    });
    
    // 初始化主窗口
    JFrame frame = new JFrame("图片画廊");
    frame.add(scrollPane);
    frame.setSize(800, 600);
    frame.setVisible(true);
    frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
    
} catch (IOException e) {
    e.printStackTrace();
}

2. 解决StretchIcon导致的间距过大问题 #

问题本质是GridLayout单元格尺寸与图片实际显示尺寸不匹配，导致留白被误判为间距，解决措施：

• 给JLabel设置水平/垂直居中对齐，让图片填充标签可用区域
• 重写面板getPreferredSize时精确计算行高，避免GridLayout分配多余空间
• 若仍有问题，可尝试将GridLayout的行间距调小，或改用BoxLayout配合自定义约束

3. 补充：双击全屏功能实现 #

给每个图片标签添加鼠标监听器，双击时打开全屏窗口：

// 在添加图片标签的循环中加入以下代码
imgLabel.addMouseListener(new MouseAdapter() {
    @Override
    public void mouseClicked(MouseEvent e) {
        if (e.getClickCount() == 2) {
            JFrame fullScreenFrame = new JFrame();
            fullScreenFrame.setUndecorated(true);
            fullScreenFrame.setExtendedState(JFrame.MAXIMIZED_BOTH);
            
            JLabel fullScreenLabel = new JLabel(new StretchIcon(image, StretchIcon.STRETCH_UNIFORM));
            fullScreenLabel.setHorizontalAlignment(JLabel.CENTER);
            fullScreenFrame.add(fullScreenLabel);
            
            // 点击全屏窗口退出
            fullScreenLabel.addMouseListener(new MouseAdapter() {
                @Override
                public void mouseClicked(MouseEvent evt) {
                    fullScreenFrame.dispose();
                }
            });
            
            fullScreenFrame.setVisible(true);
        }
    }
});

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