java.lang.Object javax.swing.ImageIcon
public class ImageIcon
一个 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 |
字段详细信息 |
---|
protected static final Component component
protected static final MediaTracker tracker
构造方法详细信息 |
---|
public ImageIcon(String filename, String description)
filename
- 包含图像的文件的名称
description
- 图像的简明文本描述
ImageIcon(String)
public ImageIcon(String filename)
new ImageIcon("images/myImage.gif")该描述被初始化为
filename
字符串。
filename
- 指定文件名或路径的 String
getDescription()
public ImageIcon(URL location, String description)
location
- 图像的 URL
description
- 图像的简明文本描述
ImageIcon(String)
public ImageIcon(URL location)
location
- 图像的 URL
getDescription()
public ImageIcon(Image image, String description)
image
- 图像
description
- 图像的简明文本描述
public ImageIcon(Image image)
image
- 图像
getDescription()
,
Image.getProperty(java.lang.String, java.awt.image.ImageObserver)
public ImageIcon(byte[] imageData, String description)
imageData
- 一个像素数组,具有受 AWT Toolkit 支持的图像格式,比如 GIF、JPEG 或从 1.3 版本开始的 PNG
description
- 图像的简明文本描述
Toolkit.createImage(java.lang.String)
public ImageIcon(byte[] imageData)
imageData
- 一个像素数组,具有受 AWT Toolkit 支持的图像格式,比如 GIF、JPEG 或从 1.3 版本开始的 PNG
Toolkit.createImage(java.lang.String)
,
getDescription()
,
Image.getProperty(java.lang.String, java.awt.image.ImageObserver)
public ImageIcon()
方法详细信息 |
---|
protected void loadImage(Image image)
image
- 图像
public int getImageLoadStatus()
MediaTracker.ABORTED
,
MediaTracker.ERRORED
,
MediaTracker.COMPLETE
public Image getImage()
Image
。
ImageIcon
的
Image
对象
public void setImage(Image image)
image
- 图像
public String getDescription()
public void setDescription(String description)
description
- 图像的简明文本描述。
public void paintIcon(Component c, Graphics g, int x, int y)
g
的坐标空间中的点 (
x
,
y
) 处绘制。如果此图标没有图像观察者,则此方法使用
c
组件作为观察者。
c
- 用作观察者的组件,如果此图标没有图像观察者
g
- 图形上下文
x
- 图标左上角的 X 坐标
y
- 图标左上角的 Y 坐标
public int getIconWidth()
Icon
中的
getIconWidth
public int getIconHeight()
Icon
中的
getIconHeight
public void setImageObserver(ImageObserver observer)
icon = new ImageIcon(...) button.setIcon(icon); icon.setImageObserver(button);
observer
- 图像观察者
public ImageObserver getImageObserver()
public String toString()
public AccessibleContext getAccessibleContext()
Accessible
中的
getAccessibleContext