原文：http://zetcode.com/java/imageicon/

在本教程中，我们将使用ImageIcon。 我们将绘制一个图标，缩放一个图标，创建一个自定义图标，并将图标放入各种 Swing 组件中。

ImageIcon

Icon是固定大小的小图片，通常用于装饰组件。 ImageIcon是Icon接口的实现，可从图像绘制图标。 可以从 URL，文件名或字节数组创建图像。

  1. paintIcon(Component c, Graphics g, int x, int y)

Icon的paintIcon()方法在指定位置绘制图标。

ImageIcon构造器

ImageIcon具有多个构造器，包括：

  • ImageIcon(byte[] imageData) - 从字节数组创建ImageIcon。
  • ImageIcon(Image image） — 从图像对象创建ImageIcon。
  • ImageIcon(String filename) - 创建一个ImageIcon指定的文件。
  • ImageIcon(URL location) - 从指定的 URL 创建一个ImageIcon。

ImageIcon可以处理 PNG，JPEG 和 GIF 图像。 如果要使用 BMP 或 ICO 图像，可以使用 image4j 库。

绘制图标

在第一个示例中，我们将在面板上绘制一个图标。

PaintingIconEx.java

  1. package com.zetcode;
  3. import java.awt.Container;
  4. import java.awt.Dimension;
  5. import java.awt.EventQueue;
  6. import java.awt.Graphics;
  7. import javax.swing.GroupLayout;
  8. import javax.swing.ImageIcon;
  9. import javax.swing.JComponent;
  10. import javax.swing.JFrame;
  11. import javax.swing.JPanel;
  13. class DrawingPanel extends JPanel {
  15.     private ImageIcon icon;
  17.     public DrawingPanel() {
  19.         loadImage();
  20.         initPanel();
  21.     }
  23.     private void loadImage() {
  25.         icon = new ImageIcon("book.jpg");
  26.     }
  28.     private void initPanel() {
  30.         int w = icon.getIconWidth();
  31.         int h = icon.getIconHeight();
  32.         setPreferredSize(new Dimension(w, h));
  33.     }    
  35.     @Override
  36.     public void paintComponent(Graphics g) {
  37.         super.paintComponent(g);
  39.         icon.paintIcon(this, g, 0, 0);
  40.     }
  41. }
  43. public class PaintingIconEx extends JFrame {
  45.     public PaintingIconEx() {
  47.         initUI();
  48.     }
  50.     private void initUI() {
  52.         DrawingPanel dpnl = new DrawingPanel();
  54.         createLayout(dpnl);
  56.         setTitle("Image");
  57.         setLocationRelativeTo(null);
  58.         setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
  59.     }
  61.     private void createLayout(JComponent... arg) {
  63.         Container pane = getContentPane();
  64.         GroupLayout gl = new GroupLayout(pane);
  65.         pane.setLayout(gl);
  67.         gl.setHorizontalGroup(gl.createSequentialGroup()
  68.                 .addComponent(arg[0])
  69.         );
  71.         gl.setVerticalGroup(gl.createParallelGroup()
  72.                 .addComponent(arg[0])
  73.         );
  75.         pack();
  76.     }
  78.     public static void main(String[] args) {
  80.         EventQueue.invokeLater(() -> {
  81.             JFrame ex = new PaintingIconEx();
  82.             ex.setVisible(true);
  83.         });
  84.     }
  85. }

该示例将文件系统中的图像加载到ImageIcon中并将其绘制在JPanel组件上。

  1. private void loadImage() {
  3.     icon = new ImageIcon("book.jpg");
  4. }

我们将 JPG 图像加载到ImageIcon中。 该图像位于项目根目录中。

  1. private void initPanel() {
  3.     int w = icon.getIconWidth();
  4.     int h = icon.getIconHeight();
  5.     setPreferredSize(new Dimension(w, h));
  6. }

在initPanel()方法中，我们使用getIconWidth()和getIconHeight()方法确定图标的宽度和高度。 我们设置面板的首选大小以匹配图标大小。

  1. @Override
  2. public void paintComponent(Graphics g) {
  3.     super.paintComponent(g);
  5.     icon.paintIcon(this, g, 0, 0);
  6. }

在paintComponent()方法中，我们使用paintIcon()方法在面板上绘制图标。

`ImageIcon`教程 - 图1

图：绘画图标

缩放图像

以下示例显示了缩放图像的简单方法。

ImageIconScaleEx.java

  1. package com.zetcode;
  3. import java.awt.Container;
  4. import java.awt.EventQueue;
  5. import java.awt.Image;
  6. import javax.swing.GroupLayout;
  7. import javax.swing.ImageIcon;
  8. import javax.swing.JComponent;
  9. import javax.swing.JFrame;
  10. import static javax.swing.JFrame.EXIT_ON_CLOSE;
  11. import javax.swing.JLabel;
  13. public class ImageIconScaleEx extends JFrame {
  15.     public ImageIconScaleEx() {
  17.         initUI();
  18.     }
  20.     private void initUI() {
  22.         ImageIcon originalIcon = new ImageIcon("slovakia.png");
  23.         JLabel originalLabel = new JLabel(originalIcon);
  25.         int width = originalIcon.getIconWidth() / 2;
  26.         int height = originalIcon.getIconHeight() / 2;
  28.         Image scaled = scaleImage(originalIcon.getImage(), width, height);
  30.         ImageIcon scaledIcon = new ImageIcon(scaled);
  32.         JLabel newLabel = new JLabel(scaledIcon);
  34.         createLayout(originalLabel, newLabel);
  36.         setTitle("Scaled icon");
  37.         setLocationRelativeTo(null);
  38.         setDefaultCloseOperation(EXIT_ON_CLOSE);
  39.     }
  41.     private Image scaleImage(Image image, int w, int h) {
  43.         Image scaled = image.getScaledInstance(w, h, Image.SCALE_SMOOTH);
  45.         return scaled;
  46.     }
  48.     private void createLayout(JComponent... arg) {
  50.         Container pane = getContentPane();
  51.         GroupLayout gl = new GroupLayout(pane);
  52.         pane.setLayout(gl);
  54.         gl.setAutoCreateContainerGaps(true);
  55.         gl.setAutoCreateGaps(true);
  57.         gl.setHorizontalGroup(gl.createSequentialGroup()
  58.                 .addComponent(arg[0])
  59.                 .addComponent(arg[1])
  60.         );
  62.         gl.setVerticalGroup(gl.createParallelGroup()
  63.                 .addComponent(arg[0])
  64.                 .addComponent(arg[1])
  65.         );
  67.         pack();
  68.     }
  70.     public static void main(String[] args) {
  72.         EventQueue.invokeLater(() -> {
  73.             ImageIconScaleEx ex = new ImageIconScaleEx();
  74.             ex.setVisible(true);
  75.         });
  76.     }
  77. }

窗口上显示了两个图像：原始图像及其旁边的缩放图像。

  1. ImageIcon originalIcon = new ImageIcon("slovakia.png");

我们将 PNG 图像读取到ImageIcon中。 该图像位于项目根目录中。

  1. int width = originalIcon.getIconWidth() / 2;
  2. int height = originalIcon.getIconHeight() / 2;

我们使用getIconWidth()和getIconHeight()方法获得原始图像的宽度和高度。

  1. Image scaled = scaleImage(originalIcon.getImage(), width, height);

我们将图标的Image，其width和height传递给scaleImage()方法，在其中执行缩放操作。

  1. private Image scaleImage(Image image, int w, int h) {
  3.     Image scaled = image.getScaledInstance(w, h, Image.SCALE_SMOOTH);
  5.     return scaled;
  6. }

getScaledInstance()创建Image的缩放版本。 我们使用Image.SCALE_SMOOTH缩放操作，该操作对图像平滑度的优先级高于缩放速度。

  1. ImageIcon scaledIcon = new ImageIcon(scaled);
  3. JLabel newLabel = new JLabel(scaledIcon);

我们从Image创建一个ImageIcon，并将其传递给JLabel组件。

`ImageIcon`教程 - 图2

图：缩放 image

自定义图标

Swing 绘画 API 也可以用于创建自定义图标。 图形上下文将传递给paintIcon()方法。

CustomIconEx.java

  1. package com.zetcode;
  3. import java.awt.BasicStroke;
  4. import java.awt.Color;
  5. import java.awt.Component;
  6. import java.awt.EventQueue;
  7. import java.awt.Graphics;
  8. import java.awt.Graphics2D;
  9. import javax.swing.Icon;
  10. import javax.swing.JFrame;
  11. import javax.swing.JLabel;
  13. class MissingIcon implements Icon {
  15.     private final int WIDTH = 32;
  16.     private final int HEIGHT = 32;
  18.     private final BasicStroke stroke = new BasicStroke(5);
  20.     @Override
  21.     public void paintIcon(Component c, Graphics g, int x, int y) {
  23.         doDrawing(g, x, y);
  24.     }
  26.     public void doDrawing(Graphics g, int x, int y) {
  28.         Graphics2D g2d = (Graphics2D) g.create();
  30.         g2d.setColor(Color.white);
  31.         g2d.fillRect(x + 1, y + 1, WIDTH - 2, HEIGHT - 2);
  33.         g2d.setColor(Color.darkGray);
  34.         g2d.drawRect(x + 1, y + 1, WIDTH - 2, HEIGHT - 2);
  36.         g2d.setColor(Color.red);
  38.         g2d.setStroke(stroke);
  39.         g2d.drawLine(x + 10, y + 10, x + WIDTH - 10, y + HEIGHT - 10);
  40.         g2d.drawLine(x + 10, y + HEIGHT - 10, x + WIDTH - 10, y + 10);
  42.         g2d.dispose();
  43.     }
  45.     @Override
  46.     public int getIconWidth() {
  47.         return WIDTH;
  48.     }
  50.     @Override
  51.     public int getIconHeight() {
  52.         return HEIGHT;
  53.     }
  54. }
  56. class MyLabel extends JLabel {
  58.     public MyLabel(Icon icon) {
  59.         super(icon);
  60.     }
  62.     @Override
  63.     public boolean isOpaque() {
  64.         return true;
  65.     }
  66. }
  68. public class CustomIconEx extends JFrame {
  70.     public CustomIconEx() {
  72.         initUI();
  73.     }
  75.     private void initUI() {
  77.         JLabel lbl = new MyLabel(new MissingIcon());
  78.         lbl.setBackground(Color.gray);
  79.         add(lbl);
  81.         setSize(250, 150);
  82.         setTitle("Custom icon");
  83.         setLocationRelativeTo(null);
  84.         setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
  85.     }
  87.     public static void main(String[] args) {
  89.         EventQueue.invokeLater(() -> {
  90.             CustomIconEx ex = new CustomIconEx();
  91.             ex.setVisible(true);
  92.         });
  93.     }
  94. }

该示例创建一个缺少的自定义图标，并在带有JLabel的窗口上显示该图标。

  1. class MissingIcon implements Icon {

要创建自定义图标，我们实现Icon接口。

  1. @Override
  2. public int getIconWidth() {
  3.     return WIDTH;
  4. }
  6. @Override
  7. public int getIconHeight() {
  8.     return HEIGHT;
  9. }

我们重写getIconWidth()和getIconHeight()方法，它们确定图标的大小。

  1. @Override
  2. public void paintIcon(Component c, Graphics g, int x, int y) {
  4.     doDrawing(g, x, y);
  5. }

我们覆盖了paintIcon()方法，在该方法中绘制了图标。 Graphics对象提供了许多绘制 2D 形状并获取有关应用图形环境的信息的方法。

  1. public void doDrawing(Graphics g, int x, int y) {
  3.     Graphics2D g2d = (Graphics2D) g.create();
  5.     g2d.setColor(Color.white);
  6.     g2d.fillRect(x + 1, y + 1, WIDTH - 2, HEIGHT - 2);
  8.     g2d.setColor(Color.darkGray);
  9.     g2d.drawRect(x + 1, y + 1, WIDTH - 2, HEIGHT - 2);
  11.     g2d.setColor(Color.red);
  13.     g2d.setStroke(stroke);
  14.     g2d.drawLine(x + 10, y + 10, x + WIDTH - 10, y + HEIGHT - 10);
  15.     g2d.drawLine(x + 10, y + HEIGHT - 10, x + WIDTH - 10, y + 10);
  17.     g2d.dispose();
  18. }

在doDrawing()方法内部，我们绘制了图标。 该过程与paintComponent()方法中的绘制相同。 Graphics2D类扩展了Graphics类，以提供对几何，坐标转换，颜色管理和文本布局的更复杂的控制。

  1. class MyLabel extends JLabel {
  3.     public MyLabel(Icon icon) {
  4.         super(icon);
  5.     }
  7.     @Override
  8.     public boolean isOpaque() {
  9.         return true;
  10.     }
  11. }

我们有一个自定义的MyLabel组件。 我们将其设为不透明，即标签具有背景。

  1. JLabel lbl = new MyLabel(new MissingIcon());

图标设置为标签组件。

`ImageIcon`教程 - 图3

图：缺少自定义图标

ImageIcon按钮

可以将ImageIcons放置在JButton组件上。

ImageIconButtonsEx.java

  1. package com.zetcode;
  3. import java.awt.Container;
  4. import java.awt.EventQueue;
  5. import javax.swing.GroupLayout;
  6. import javax.swing.ImageIcon;
  7. import javax.swing.JButton;
  8. import javax.swing.JComponent;
  9. import javax.swing.JFrame;
  10. import static javax.swing.JFrame.EXIT_ON_CLOSE;
  12. public class ImageIconButtonsEx extends JFrame {
  14.     public ImageIconButtonsEx() {
  16.         initUI();
  17.     }
  19.     private void initUI() {
  21.         ImageIcon quitIcon = new ImageIcon("quit.png");
  22.         ImageIcon saveIcon = new ImageIcon("save.png");
  23.         ImageIcon homeIcon = new ImageIcon("home.png");
  25.         JButton quitBtn = new JButton(quitIcon);
  26.         JButton saveBtn = new JButton(saveIcon);
  27.         JButton homeBtn = new JButton(homeIcon);
  29.         createLayout(quitBtn, saveBtn, homeBtn);
  31.         setTitle("JButtons");
  32.         setLocationRelativeTo(null);
  33.         setDefaultCloseOperation(EXIT_ON_CLOSE);
  34.     }
  36.     private void createLayout(JComponent... arg) {
  38.         Container pane = getContentPane();
  39.         GroupLayout gl = new GroupLayout(pane);
  40.         pane.setLayout(gl);
  42.         gl.setAutoCreateContainerGaps(true);
  43.         gl.setAutoCreateGaps(true);
  45.         gl.setHorizontalGroup(gl.createSequentialGroup()
  46.                 .addComponent(arg[0])
  47.                 .addComponent(arg[1])
  48.                 .addComponent(arg[2])
  49.         );
  51.         gl.setVerticalGroup(gl.createParallelGroup()
  52.                 .addComponent(arg[0])
  53.                 .addComponent(arg[1])
  54.                 .addComponent(arg[2])
  55.         );
  57.         gl.linkSize(arg[0], arg[1], arg[2]);
  59.         pack();
  60.     }
  62.     public static void main(String[] args) {
  64.         EventQueue.invokeLater(() -> {
  65.             ImageIconButtonsEx ex = new ImageIconButtonsEx();
  66.             ex.setVisible(true);
  67.         });
  68.     }
  69. }

我们有三个按钮。 它们每个都显示一个ImageIcon。

  1. ImageIcon quitIcon = new ImageIcon("quit.png");
  2. ImageIcon saveIcon = new ImageIcon("save.png");
  3. ImageIcon homeIcon = new ImageIcon("home.png");

创建了三个ImageIcons。 我们将文件名传递给每个构造器。 PNG 文件位于项目根目录中。

  1. JButton quitBtn = new JButton(quitIcon);
  2. JButton saveBtn = new JButton(saveIcon);
  3. JButton homeBtn = new JButton(homeIcon);

JButton组件接受ImageIcon作为参数。

`ImageIcon`教程 - 图4

图：图像 buttons

JFrame图标

JFrame组件可以在其标题栏中显示一个图标。 它显示在标题栏的左侧。

FrameIconEx.java

  1. package com.zetcode;
  3. import java.awt.EventQueue;
  4. import javax.swing.ImageIcon;
  5. import javax.swing.JFrame;
  6. import static javax.swing.JFrame.EXIT_ON_CLOSE;
  8. public class FrameIconEx extends JFrame {
  10.     public FrameIconEx() {
  12.         initUI();
  13.     }
  15.     private void initUI() {
  17.         ImageIcon webIcon = new ImageIcon("web.png");
  19.         setIconImage(webIcon.getImage());
  21.         setTitle("Icon");
  22.         setSize(300, 200);
  23.         setLocationRelativeTo(null);
  24.         setDefaultCloseOperation(EXIT_ON_CLOSE);
  25.     }
  27.     public static void main(String[] args) {
  29.         EventQueue.invokeLater(() -> {
  30.             FrameIconEx ex = new FrameIconEx();
  31.             ex.setVisible(true);
  32.         });
  33.     }
  34. }

web.png是一个很小的22x22px图像文件。

  1. ImageIcon webIcon = new ImageIcon("web.png");

我们从位于项目根目录中的 PNG 文件创建一个ImageIcon。

  1. setIconImage(webIcon.getImage());

setIconImage()设置要显示为该窗口图标的图像。 getImage()返回图标的Image。

`ImageIcon`教程 - 图5

图：图标

JLabel中的ImageIcon

在下面的示例中，我们将ImageIcons放入JLabel组件中。

ImageIconLabelEx.java

  1. package com.zetcode;
  3. import java.awt.Container;
  4. import java.awt.EventQueue;
  5. import javax.swing.GroupLayout;
  6. import javax.swing.ImageIcon;
  7. import javax.swing.JComponent;
  8. import javax.swing.JFrame;
  9. import static javax.swing.JFrame.EXIT_ON_CLOSE;
  10. import javax.swing.JLabel;
  12. public class ImageIconLabelEx extends JFrame {
  14.     public ImageIconLabelEx() {
  16.         initUI();
  17.     }
  19.     private void initUI() {
  21.         JLabel lbl1 = new JLabel(new ImageIcon("cpu.png"));
  22.         JLabel lbl2 = new JLabel(new ImageIcon("drive.png"));
  23.         JLabel lbl3 = new JLabel(new ImageIcon("laptop.png"));
  24.         JLabel lbl4 = new JLabel(new ImageIcon("player.png"));
  25.         JLabel lbl5 = new JLabel(new ImageIcon("pda.png"));
  27.         createLayout(lbl1, lbl2, lbl3, lbl4, lbl5);
  29.         setTitle("Icons");
  30.         setLocationRelativeTo(null);
  31.         setDefaultCloseOperation(EXIT_ON_CLOSE);
  32.     }
  34.     private void createLayout(JComponent... arg) {
  36.         Container pane = getContentPane();
  37.         GroupLayout gl = new GroupLayout(pane);
  38.         pane.setLayout(gl);        
  40.         gl.setAutoCreateContainerGaps(true);
  41.         gl.setAutoCreateGaps(true);
  43.         gl.setHorizontalGroup(gl.createSequentialGroup()
  44.                 .addComponent(arg[0])
  45.                 .addComponent(arg[1])
  46.                 .addComponent(arg[2])
  47.                 .addComponent(arg[3])
  48.                 .addComponent(arg[4])
  49.         );
  51.         gl.setVerticalGroup(gl.createParallelGroup()
  52.                 .addComponent(arg[0])
  53.                 .addComponent(arg[1])
  54.                 .addComponent(arg[2])
  55.                 .addComponent(arg[3])
  56.                 .addComponent(arg[4])
  57.         );
  59.         pack();
  60.     }    
  62.     public static void main(String[] args) {
  64.         EventQueue.invokeLater(() -> {
  65.             ImageIconLabelEx ex = new ImageIconLabelEx();
  66.             ex.setVisible(true);
  67.         });
  68.     }
  69. }

项目根目录中有五个 PNG 文件。 它们显示在JLabel组件的窗口中。

  1. JLabel lbl1 = new JLabel(new ImageIcon("cpu.png"));
  2. JLabel lbl2 = new JLabel(new ImageIcon("drive.png"));
  3. JLabel lbl3 = new JLabel(new ImageIcon("laptop.png"));
  4. JLabel lbl4 = new JLabel(new ImageIcon("player.png"));
  5. JLabel lbl5 = new JLabel(new ImageIcon("pda.png"));

JLabel具有一个构造器，该构造器将ImageIcon作为参数。

`ImageIcon`教程 - 图6

图：图标s in labels

JTabbedPane中的ImageIcon

JTabbedPane是 Swing 组件，允许用户通过单击选项卡在一组组件之间切换。 这些选项卡可以包含ImageIcons。

ImageIconTabbedPaneEx

  1. package com.zetcode;
  3. import java.awt.Container;
  4. import java.awt.Dimension;
  5. import java.awt.EventQueue;
  6. import javax.swing.GroupLayout;
  7. import javax.swing.ImageIcon;
  8. import javax.swing.JComponent;
  9. import javax.swing.JFrame;
  10. import static javax.swing.JFrame.EXIT_ON_CLOSE;
  11. import javax.swing.JPanel;
  12. import javax.swing.JTabbedPane;
  14. public class ImageIconTabbedPaneEx extends JFrame {
  16.     public ImageIconTabbedPaneEx() {
  18.         initUI();
  19.     }
  21.     private void initUI() {
  23.         ImageIcon icon1 = new ImageIcon("dot1.png");
  24.         ImageIcon icon2 = new ImageIcon("dot2.png");
  25.         ImageIcon icon3 = new ImageIcon("dot3.png");
  27.         JTabbedPane tbp = new JTabbedPane();
  28.         tbp.setPreferredSize(new Dimension(350, 250));
  30.         tbp.addTab("", icon1, new JPanel());
  31.         tbp.addTab("", icon2, new JPanel());
  32.         tbp.addTab("", icon3, new JPanel());
  34.         createLayout(tbp);
  36.         setTitle("Icons");
  37.         setLocationRelativeTo(null);
  38.         setDefaultCloseOperation(EXIT_ON_CLOSE);
  39.     }
  41.     private void createLayout(JComponent... arg) {
  43.         Container pane = getContentPane();
  44.         GroupLayout gl = new GroupLayout(pane);
  45.         pane.setLayout(gl);        
  47.         gl.setAutoCreateContainerGaps(true);
  48.         gl.setAutoCreateGaps(true);
  50.         gl.setHorizontalGroup(gl.createSequentialGroup()
  51.                 .addComponent(arg[0])
  52.         );
  54.         gl.setVerticalGroup(gl.createParallelGroup()
  55.                 .addComponent(arg[0])
  56.         );
  58.         pack();
  59.     }    
  61.     public static void main(String[] args) {
  63.         EventQueue.invokeLater(() -> {
  64.             ImageIconTabbedPaneEx ex = new ImageIconTabbedPaneEx();
  65.             ex.setVisible(true);
  66.         });
  67.     }
  68. }

该示例在JTabbedPane组件的选项卡中显示ImageIcons。

  1. ImageIcon icon1 = new ImageIcon("dot1.png");

ImageIcon已创建。

  1. JTabbedPane tbp = new JTabbedPane();

JTabbedPane已创建。

  1. tbp.addTab("", icon1, new JPanel());

addTab()方法的第二个参数是ImageIcon。

`ImageIcon`教程 - 图7

图：JTabbedPane图标

本教程专门针对 Java ImageIcon。 您可能也对相关教程感兴趣：用 Java 读写 ICO 图像， Java Swing 教程， Java 教程，用 Java 显示图像 。