JavaTM 2 Platform
Standard Ed. 5.0

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 包中添加了支持所有 JavaBeansTM 长期存储的功能。请参见 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

返回:
ImageIconImage 对象

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

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策