ImageIcon (Java Platform SE 8 )

java.lang.Object
- javax.swing.ImageIcon

All Implemented Interfaces:

Serializable ， Accessible ， Icon
```
public class ImageIcon
extends Object
implements Icon, Serializable, Accessible
```
从图像绘制图标的图标界面的实现。使用MediaTracker预先从URL，文件名或字节数组创建的图像，以监视图像的加载状态。
有关使用图像图标的更多信息和示例，请参阅Java教程中的 How to Use Icons 。

警告：此类的序列化对象与将来的Swing版本不兼容。当前的序列化支持适用于运行相同版本的Swing的应用程序之间的短期存储或RMI。从1.4开始，对所有JavaBeans的长期存储的支持已被添加到java.beans包中。请参阅XMLEncoder 。

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`protected class`	`ImageIcon.AccessibleImageIcon` 这个类实现了可访问性支持 `ImageIcon`类。

Field Summary

Fields
Modifier and Type	Field and Description
`protected static Component`	`component` 已弃用自1.8
`protected static MediaTracker`	`tracker` 已弃用自1.8

构造方法摘要

构造方法
Constructor and Description
`ImageIcon()` 创建未初始化的图像图标。
`ImageIcon(byte[] imageData)` 从包含支持的图像格式（如GIF，JPEG或（1.3）PNG）的图像文件中读取的字节数组创建一个ImageIcon。
`ImageIcon(byte[] imageData, String description)` 从包含支持的图像格式（如GIF，JPEG或（1.3）PNG）的图像文件中读取的字节数组创建一个ImageIcon。
`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。

方法摘要

所有方法接口方法具体的方法
Modifier and Type	Method and Description
`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()` 返回此图像的字符串表示形式。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- 字段详细信息
  - component
```
@Deprecated
protected static final Component component
```
    已弃用自1.8
    
    不要使用此共享组件，用于跟踪图像加载。仅用于向后兼容。
  - tracker
```
@Deprecated
protected static final MediaTracker tracker
```
    已弃用自1.8
    
    不要使用此共享媒体跟踪器，用于加载图像。仅用于向后兼容。
- 构造方法详细信息
  - ImageIcon
```
public ImageIcon(String filename,
                 String description)
```
    从指定的文件创建一个ImageIcon。该图像将通过使用MediaTracker进行预加载，以监视图像的加载状态。
    
    参数
    
    filename - 包含图像的文件的名称
    
    description - 图像的简短文字说明
    
    另请参见：
    
    ImageIcon(String)
  - ImageIcon
```
@ConstructorProperties(value="description")
public ImageIcon(String filename)
```
    从指定的文件创建一个ImageIcon。该图像将通过使用MediaTracker进行预加载，以监视图像的加载状态。指定的String可以是文件名或文件路径。指定路径时，请使用Internet标准正斜杠（“/”）作为分隔符。（字符串转换为URL，因此所有系统上的正斜杠均可使用）。例如，指定：
```
  new ImageIcon("images/myImage.gif") 
```
    描述被初始化为filename字符串。
    参数
    
    filename - 指定文件名或路径的字符串
    
    另请参见：
    
    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。如果图像具有作为字符串的“注释”属性，则使用该字符串作为该图标的描述。
    
    参数
    
    image - 图像
    
    另请参见：
    
    getDescription() ， Image.getProperty(java.lang.String, java.awt.image.ImageObserver)
  - ImageIcon
```
public ImageIcon(byte[] imageData,
                 String description)
```
    从包含支持的图像格式（如GIF，JPEG或（1.3）PNG）的图像文件中读取的字节数组创建一个ImageIcon。通常这个数组是通过使用Class.getResourceAsStream（）读取图像创建的，但字节数组也可以静态存储在一个类中。
    
    参数
    
    imageData - 由AWT Toolkit支持的图像格式的像素阵列，如GIF，JPEG或（至1.3）PNG
    
    description - 图像的简短文字描述
    
    另请参见：
    
    Toolkit.createImage(java.lang.String)
  - ImageIcon
```
public ImageIcon(byte[] imageData)
```
    从包含支持的图像格式（如GIF，JPEG或（1.3）PNG）的图像文件中读取的字节数组创建一个ImageIcon。通常这个数组是通过使用Class.getResourceAsStream（）读取图像创建的，但字节数组也可以静态存储在一个类中。如果生成的图像具有作为字符串的“注释”属性，则使用该字符串作为该图标的描述。
    
    参数
    
    imageData - 由AWT工具包支持的图像格式的像素阵列，如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 。
    
    结果
    
    这个 Image对象为 ImageIcon
  - setImage
```
public void setImage(Image image)
```
    设置此图标显示的图像。
    
    参数
    
    image - 图像
  - getDescription
```
public String getDescription()
```
    获取图像的描述。这意味着是对象的简短文本描述。例如，它可能被呈现给盲人以给出图像的目的的指示。说明可能为空。
    
    结果
    
    图片的简短文字描述
  - setDescription
```
public void setDescription(String description)
```
    设置图像的描述。这意味着是对象的简短文本描述。例如，它可能被呈现给盲人以给出图像的目的的指示。
    
    参数
    
    description - 图像的简短文字说明
  - paintIcon
```
public void paintIcon(Component c,
                      Graphics g,
                      int x,
                      int y)
```
    画图标。图标的左上角的点（被绘制x ， y在图形上下文的坐标空间） g 。如果该图标没有图像观察者，则该方法使用c组件作为观察者。
    
    Specified by:
    
    paintIcon在接口 Icon
    
    参数
    
    c - 如果该图标没有图像观察者，则用作观察者的组件
    
    g - 图形上下文
    
    x - 图标左上角的X坐标
    
    y - 图标左上角的Y坐标
  - getIconWidth
```
public int getIconWidth()
```
    获取图标的宽度。
    
    Specified by:
    
    getIconWidth在接口 Icon
    
    结果
    
    该图标的宽度（以像素为单位）
  - getIconHeight
```
public int getIconHeight()
```
    获取图标的高度。
    
    Specified by:
    
    getIconHeight在接口 Icon
    
    结果
    
    该图标的高度（以像素为单位）
  - setImageObserver
```
public void setImageObserver(ImageObserver observer)
```
    设置图像的图像观察者。如果ImageIcon包含动画GIF，则设置此属性，因此通知观察者更新其显示。例如：
```
  icon = new ImageIcon(...)
     button.setIcon(icon);
     icon.setImageObserver(button); 
```
    参数
    
    observer - 图像观察者
  - getImageObserver
```
public ImageObserver getImageObserver()
```
    返回图像的图像观察者。
    
    结果
    
    图像观察者，可以为空
  - toString
```
public String toString()
```
    返回此图像的字符串表示形式。
    
    重写：
    
    toString在类 Object
    
    结果
    
    表示此图像的字符串
  - getAccessibleContext
```
public AccessibleContext getAccessibleContext()
```
    获取与此ImageIcon关联的AccessibleContext。对于图像图标，AccessibleContext采用AccessibleImageIcon的形式。如有必要，将创建一个新的AccessibleImageIcon实例。
    
    Specified by:
    
    getAccessibleContext在界面 Accessible
    
    结果
    
    AccessibleImageIcon作为此ImageIcon的AccessibleContext
    
    从以下版本开始：
    
    1.3

Class ImageIcon

Nested Class Summary

Field Summary

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

字段详细信息

component

tracker

构造方法详细信息

ImageIcon

ImageIcon

ImageIcon

ImageIcon

ImageIcon

ImageIcon

ImageIcon

ImageIcon

ImageIcon

方法详细信息

loadImage

getImageLoadStatus

getImage

setImage

getDescription

setDescription

paintIcon

getIconWidth

getIconHeight

setImageObserver

getImageObserver

toString

getAccessibleContext