如何让Java Swing窗体的背景图片随窗体缩放自适应？

原代码直接用JLabel加载图片作为背景，由于JLabel不会自动缩放图片，导致窗体大小变化时，图片尺寸固定，出现裁切或留白。下面提供两种可靠的解决方式：

方式一：自定义可缩放背景的JLabel #

通过继承JLabel并重写paintComponent方法，在绘制时将图片缩放到组件当前的尺寸，确保填充整个窗体。

自定义背景Label代码 #

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

class ScaledBackgroundLabel extends JLabel {
    private Image backgroundImage;

    public ScaledBackgroundLabel(ImageIcon icon) {
        this.backgroundImage = icon.getImage();
        setLayout(new BorderLayout()); // 支持添加其他组件
    }

    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g);
        // 获取当前组件的宽高，将图片缩放后填充整个区域
        g.drawImage(backgroundImage, 0, 0, getWidth(), getHeight(), this);
    }
}

使用示例 #

public class BackgroundFrame extends JFrame {
    public BackgroundFrame() {
        ImageIcon img = new ImageIcon("gari.png");
        ScaledBackgroundLabel backImg = new ScaledBackgroundLabel(img);
        setContentPane(backImg); // 将自定义Label设为内容面板

        setTitle("缩放背景示例");
        setSize(800, 600);
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setVisible(true);
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> new BackgroundFrame());
    }
}

方式二：自定义背景面板（推荐） #

直接将窗体的内容面板替换为自定义的JPanel，重写paintComponent实现图片缩放，这种方式更适合作为底层容器管理其他组件。

自定义背景面板代码 #

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

class ScaledBackgroundPanel extends JPanel {
    private Image backgroundImage;

    public ScaledBackgroundPanel(ImageIcon icon) {
        this.backgroundImage = icon.getImage();
        setLayout(new BorderLayout());
    }

    @Override
    protected void paintComponent(Graphics g) {
        super.paintComponent(g);
        // 缩放图片并填充整个面板
        g.drawImage(backgroundImage, 0, 0, getWidth(), getHeight(), this);
    }
}

使用示例 #

public class BackgroundFrame extends JFrame {
    public BackgroundFrame() {
        ImageIcon img = new ImageIcon("gari.png");
        ScaledBackgroundPanel backgroundPanel = new ScaledBackgroundPanel(img);
        setContentPane(backgroundPanel);

        // 可添加其他组件，比如按钮
        JButton testBtn = new JButton("测试按钮");
        backgroundPanel.add(testBtn, BorderLayout.CENTER);

        setTitle("缩放背景示例");
        setSize(800, 600);
        setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        setVisible(true);
    }

    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> new BackgroundFrame());
    }
}

保持图片比例的优化 #

如果需要避免图片拉伸变形，可在paintComponent中计算缩放比例，按原比例缩放并居中绘制：

@Override
protected void paintComponent(Graphics g) {
    super.paintComponent(g);
    int panelWidth = getWidth();
    int panelHeight = getHeight();
    int imgWidth = backgroundImage.getWidth(this);
    int imgHeight = backgroundImage.getHeight(this);

    // 计算等比例缩放的比例
    double scale = Math.min((double) panelWidth / imgWidth, (double) panelHeight / imgHeight);
    int scaledWidth = (int) (imgWidth * scale);
    int scaledHeight = (int) (imgHeight * scale);
    // 居中绘制的坐标
    int x = (panelWidth - scaledWidth) / 2;
    int y = (panelHeight - scaledHeight) / 2;

    g.drawImage(backgroundImage, x, y, scaledWidth, scaledHeight, this);
}

内容的提问来源于stack exchange，提问作者S. S. Mahmud Turza