- 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
。- 从以下版本开始:
- 1.2
- 另请参见:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class 描述 protected class
ImageIcon.AccessibleImageIcon
这个类实现ImageIcon
类的可访问性支持。
-
Field Summary
Fields Modifier and Type Field 描述 protected static Component
component
已过时。自1.8protected static MediaTracker
tracker
已过时。自1.8
-
构造方法摘要
构造方法 Constructor 描述 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 方法 描述 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()
返回此图像的字符串表示形式。
-
-
-
字段详细信息
-
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("description") 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。 如果图像具有作为字符串的“注释”属性,则使用该字符串作为该图标的描述。- 参数
-
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工具包支持的图像格式的像素阵列,如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
组件作为观察者。
-
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()
返回图像的图像观察者。- 结果
- 图像观察者,可以为空
-
getAccessibleContext
@BeanProperty(expert=true, description="The AccessibleContext associated with this ImageIcon.") public AccessibleContext getAccessibleContext()
获取与此ImageIcon关联的AccessibleContext。 对于图像图标,AccessibleContext采用AccessibleImageIcon的形式。 如有必要,将创建一个新的AccessibleImageIcon实例。- Specified by:
-
getAccessibleContext
在接口Accessible
- 结果
- AccessibleImageIcon作为此ImageIcon的AccessibleContext
- 从以下版本开始:
- 1.3
-
-