Java Swing JLabel 圖標使用全解析：自定義繪製與 ImageIcon 圖片加載

JLabel 圖標基礎

JLabel 可同時顯示文本與圖標，通過實現 Icon 接口實現自定義繪製，或使用 ImageIcon 加載圖片資源。核心構造方法：

JLabel(String text, Icon icon, int horizontalAlignment)
JLabel(Icon icon)
JLabel(String text, int horizontalAlignment)

方式一：實現 Icon 接口自定義繪製

需實現三個方法：paintIcon()、getIconWidth()、getIconHeight()。

public class CircleIcon implements Icon {
    private final int diameter;
    private final Color color;
    
    public CircleIcon(int diameter, Color color) {
        this.diameter = diameter;
        this.color = color;
    }
    
    @Override
    public void paintIcon(Component c, Graphics g, int x, int y) {
        Graphics2D g2 = (Graphics2D) g.create();
        g2.setRenderingHint(RenderingHints.KEY_ANTIALIASING, RenderingHints.VALUE_ANTIALIAS_ON);
        g2.setColor(color);
        g2.fillOval(x, y, diameter, diameter);
        g2.dispose();
    }
    
    @Override public int getIconWidth() { return diameter; }
    @Override public int getIconHeight() { return diameter; }
}

// 使用示例
JLabel label = new JLabel("圓形圖標", new CircleIcon(32, Color.RED), SwingConstants.CENTER);
label.setVerticalTextPosition(SwingConstants.BOTTOM); // 文本在圖標下方
label.setHorizontalTextPosition(SwingConstants.CENTER);

方式二：ImageIcon 加載圖片資源

常用構造方法

• ImageIcon(String filename) — 相對/絕對路徑
• ImageIcon(URL location) — 推薦：類路徑加載
• ImageIcon(byte[] imageData) — 字節數組
• ImageIcon(Image image) — Image 對象

類路徑加載最佳實踐

// 獲取類路徑下圖片 URL
URL imgUrl = getClass().getResource("/images/logo.png"); // 絕對路徑（從 classpath 根）
// 或
URL imgUrl = MyClass.class.getResource("icon.png"); // 相對路徑（同包目錄）

if (imgUrl != null) {
    Icon icon = new ImageIcon(imgUrl);
    JLabel label = new JLabel("帶圖標標簽", icon, SwingConstants.LEFT);
    label.setIconTextGap(8); // 圖文間距
} else {
    System.err.println("圖片資源未找到");
}

完整可運行示例

public class ImageIconDemo extends JFrame {
    public ImageIconDemo() {
        setTitle("ImageIcon 示例");
        setDefaultCloseOperation(EXIT_ON_CLOSE);
        setLayout(new FlowLayout());
        
        // 從類路徑加載
        URL url = getClass().getResource("/images/button.jpg");
        Icon icon = (url != null) ? new ImageIcon(url) : null;
        
        JLabel label = new JLabel("圖片標簽", icon, SwingConstants.CENTER);
        label.setHorizontalTextPosition(SwingConstants.CENTER);
        label.setVerticalTextPosition(SwingConstants.BOTTOM);
        label.setOpaque(true);
        label.setBackground(Color.LIGHT_GRAY);
        label.setBorder(BorderFactory.createEmptyBorder(10, 10, 10, 10));
        
        add(label);
        pack();
        setLocationRelativeTo(null);
    }
    
    public static void main(String[] args) {
        SwingUtilities.invokeLater(() -> new ImageIconDemo().setVisible(true));
    }
}

進階技巧與注意事項

掌握 Icon 自定義繪製與 ImageIcon 資源加載兩種方式，可滿足從簡單裝飾到複雜圖形化界面的各種需求。

1. 上一篇文章： JDBC 連接 Oracle 數據庫 URL 格式錯誤排查與正確寫法
2. 下一篇文章： 解決 Eclipse 中 XML 文件「Content is not allowed in prolog」錯誤

Java 綜合教學

Servlet 技術演進與生命週期深度解析：從 CGI 到多線程模型

Servlet 技術演進與生命週期深度解析 Servlet

網上圖書商城實戰（四）：購物車模塊完整實現——資料庫設計、實體、DAO、Service、前端 JS 全解析

網上圖書商城實戰（四）：購物車模塊完整實現 本文詳細記錄購物

從零構建簡易 Servlet 容器：核心原理與代碼實戰

前言 在上一篇文章中，我們實現了一個基礎的 Java Web

Java 集合框架深度解析：TreeSet、Comparable 與 Comparator 實戰

Java 集合框架深度解析：TreeSet、Comparab