javax.swing
类 ImageIcon

java.lang.Object
  javax.swing.ImageIcon

所有已实现的接口：

Serializable, Accessible, Icon

public class ImageIcon
extends Object
implements Icon, Serializable, Accessible

一个 Icon 接口的实现，它根据 Image 绘制 Icon。可使用 MediaTracker 预载根据 URL、文件名或字节数组创建的图像，以监视该图像的加载状态。

有关使用图像图标的更多信息和示例，请参阅 The Java Tutorial 中的 How to Use Icons 一节。

警告：此类的序列化对象与以后的 Swing 版本不兼容。当前序列化支持适用于短期存储，或适用于在运行相同 Swing 版本的应用程序之间进行 RMI（Remote Method Invocation，远程方法调用）。从 1.4 版本开始，已在 java.beans 包中添加了支持所有 JavaBeans^TM 长期存储的功能。请参见 XMLEncoder。

嵌套类摘要

protected class

ImageIcon.AccessibleImageIcon 此类实现 ImageIcon 类的可访问性支持。

字段摘要

protected static Component	component
protected static MediaTracker	tracker

构造方法摘要

ImageIcon()
创建一个未初始化的图像图标。

ImageIcon(byte[] imageData)
根据字节数组创建一个 ImageIcon，这些字节读取自一个包含受支持图像格式（比如 GIF、JPEG 或从 1.3 版本开始的 PNG）的图像文件。

ImageIcon(byte[] imageData, String description)
根据字节数组创建一个 ImageIcon，这些字节读取自一个包含受支持图像格式（比如 GIF、JPEG 或从 1.3 版本开始的 PNG）的图像文件。

ImageIcon(Image image)
根据图像对象创建一个 ImageIcon。

ImageIcon(Image image, String description)
根据图像创建一个 ImageIcon。

ImageIcon(String filename)
根据指定的文件创建一个 ImageIcon。

ImageIcon(String filename, String description)
根据指定的文件创建一个 ImageIcon。

ImageIcon(URL location)
根据指定的 URL 创建一个 ImageIcon。

ImageIcon(URL location, String description)
根据指定的 URL 创建一个 ImageIcon。

方法摘要

AccessibleContext	getAccessibleContext() 获得与此 ImageIcon 关联的 AccessibleContext。
String	getDescription() 获得图像的描述。
int	getIconHeight() 获得图标的高度。
int	getIconWidth() 获得图标的宽度。
Image	getImage() 返回此图标的 Image。
int	getImageLoadStatus() 返回图像加载操作的状态。
ImageObserver	getImageObserver() 返回图像的图像观察者。
protected void	loadImage(Image image) 加载图像，并且只在图像已加载时返回。
void	paintIcon(Component c, Graphics g, int x, int y) 绘制图标。
void	setDescription(String description) 设置图像的描述。
void	setImage(Image image) 设置由此图标显示的图像。
void	setImageObserver(ImageObserver observer) 设置图像的图像观察者。
String	toString() 返回此图像的字符串表示形式。

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

component

protected static final Component component

tracker

protected static final MediaTracker tracker

构造方法详细信息

ImageIcon

public ImageIcon(String filename,
                 String description)

根据指定的文件创建一个 ImageIcon。使用 MediaTracker 预载图像以监视图像的加载状态。

参数：

filename - 包含图像的文件的名称

description - 图像的简明文本描述

另请参见：

ImageIcon(String)

ImageIcon

public ImageIcon(String filename)

根据指定的文件创建一个 ImageIcon。使用 MediaTracker 预载图像以监视图像的加载状态。指定 String 可以是一个文件名或是一条文件路径。在指定一条路径时，可使用 Internet 标准正斜杠 ("/") 作为分隔符。（该字符串被转换成一个 URL，而正斜杠适用于所有系统。）例如，指定：

    new ImageIcon("images/myImage.gif") 

该描述被初始化为 filename 字符串。

参数：

filename - 指定文件名或路径的 String

另请参见：

getDescription()

ImageIcon

public ImageIcon(URL location,
                 String description)

根据指定的 URL 创建一个 ImageIcon。使用 MediaTracker 预载图像以监视图像的加载状态。

参数：

location - 图像的 URL

description - 图像的简明文本描述

另请参见：

ImageIcon(String)

ImageIcon

public ImageIcon(URL location)

根据指定的 URL 创建一个 ImageIcon。使用 MediaTracker 预载图像以监视图像的加载状态。图标的描述被初始化为 URL 的字符串表示形式。

参数：

location - 图像的 URL

另请参见：

getDescription()

ImageIcon

public ImageIcon(Image image,
                 String description)

根据图像创建一个 ImageIcon。

参数：

image - 图像

description - 图像的简明文本描述

ImageIcon

public ImageIcon(Image image)

根据图像对象创建一个 ImageIcon。如果图像有一个字符串形式的 "comment" 属性，则该字符串被用作此图标的描述。

参数：

image - 图像

另请参见：

getDescription(), Image.getProperty(java.lang.String, java.awt.image.ImageObserver)

ImageIcon

public ImageIcon(byte[] imageData,
                 String description)

根据字节数组创建一个 ImageIcon，这些字节读取自一个包含受支持图像格式（比如 GIF、JPEG 或从 1.3 版本开始的 PNG）的图像文件。通常，此数组是通过使用 Class.getResourceAsStream() 读取图像文件来创建的，但该字节数组也可以静态地存储在某个类中。

参数：

imageData - 一个像素数组，具有受 AWT Toolkit 支持的图像格式，比如 GIF、JPEG 或从 1.3 版本开始的 PNG

description - 图像的简明文本描述

另请参见：

Toolkit.createImage(java.lang.String)

ImageIcon

public ImageIcon(byte[] imageData)

根据字节数组创建一个 ImageIcon，这些字节读取自一个包含受支持图像格式（比如 GIF、JPEG 或从 1.3 版本开始的 PNG）的图像文件。通常，此数组是通过使用 Class.getResourceAsStream() 读取一幅图像来创建的，但该字节数组也可以静态地存储在某个类中。如果得到的图像有一个字符串形式的 "comment" 属性，则该字符串被用作此图标的描述。

参数：

imageData - 一个像素数组，具有受 AWT Toolkit 支持的图像格式，比如 GIF、JPEG 或从 1.3 版本开始的 PNG

另请参见：

Toolkit.createImage(java.lang.String), getDescription(), Image.getProperty(java.lang.String, java.awt.image.ImageObserver)

ImageIcon

public ImageIcon()

创建一个未初始化的图像图标。

方法详细信息

loadImage

protected void loadImage(Image image)

加载图像，并且只在图像已加载时返回。

参数：

image - 图像

getImageLoadStatus

public int getImageLoadStatus()

返回图像加载操作的状态。

返回：

由 java.awt.MediaTracker 定义的加载状态

另请参见：

MediaTracker.ABORTED, MediaTracker.ERRORED, MediaTracker.COMPLETE

getImage

public Image getImage()

返回此图标的 Image。

返回：

此 ImageIcon 的 Image 对象

setImage

public void setImage(Image image)

设置由此图标显示的图像。

参数：

image - 图像

getDescription

public String getDescription()

获得图像的描述。此描述应该是该对象的简明文本描述。例如，可以将它呈现给盲人用户，为他们提供该图像用途的指示。该描述可以为 null。

返回：

图像的简明文本描述。

setDescription

public void setDescription(String description)

设置图像的描述。此描述应该是该对象的简明文本描述。例如，可以将它呈现给盲人用户，为他们提供该图像用途的指示。

参数：

description - 图像的简明文本描述。

paintIcon

public void paintIcon(Component c,
                      Graphics g,
                      int x,
                      int y)

绘制图标。图标的左上角在图形上下文 g 的坐标空间中的点 (x, y) 处绘制。如果此图标没有图像观察者，则此方法使用 c 组件作为观察者。

指定者：

接口 Icon 中的 paintIcon

参数：

c - 用作观察者的组件，如果此图标没有图像观察者

g - 图形上下文

x - 图标左上角的 X 坐标

y - 图标左上角的 Y 坐标

getIconWidth

public int getIconWidth()

获得图标的宽度。

指定者：

接口 Icon 中的 getIconWidth

返回：

此图标的宽度，以像素为单位

getIconHeight

public int getIconHeight()

获得图标的高度。

指定者：

接口 Icon 中的 getIconHeight

返回：

此图标的高度，以像素为单位

setImageObserver

public void setImageObserver(ImageObserver observer)

设置图像的图像观察者。如果 ImageIcon 包含一个动画 GIF，则设置此属性，而观察者获得更新其显示的通知。例如：

     icon = new ImageIcon(...)
     button.setIcon(icon);
     icon.setImageObserver(button);
 

参数：

observer - 图像观察者

getImageObserver

public ImageObserver getImageObserver()

返回图像的图像观察者。

返回：

图像观察者，它可以为 null

toString

public String toString()

返回此图像的字符串表示形式。

覆盖：

类 Object 中的 toString

返回：

表示此图像的字符串

getAccessibleContext

public AccessibleContext getAccessibleContext()

获得与此 ImageIcon 关联的 AccessibleContext。对于图像图标，AccessibleContext 采用 AccessibleImageIcon 的形式。如有必要，可创建一个新的 AccessibleImageIcon 实例。

指定者：

接口 Accessible 中的 getAccessibleContext

返回：

一个 AccessibleImageIcon，它将充当此 ImageIcon 的 AccessibleContext

从以下版本开始：

1.3