模块  java.desktop
软件包  javax.swing

Class ImageIcon

  • 实现的所有接口
    Serializable ， Accessible ， Icon 
    public class ImageIcon
extends Object
implements Icon, Serializable, Accessible
    Icon界面的一个实现，用于绘制图像中的图标。 使用MediaTracker预先加载从URL，文件名或字节数组创建的图像，以监视图像的加载状态。

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

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

    从以下版本开始：
    1.2
    另请参见：
    Serialized Form

    • 字段详细信息

      • component

        @Deprecated
protected static final Component component
        Deprecated.
        since 1.8
        请勿使用此共享组件，该组件用于跟踪图像加载。 它仅用于向后兼容。

      • tracker

        @Deprecated
protected static final MediaTracker tracker
        Deprecated.
        since 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​(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（）读取图像创建的，但字节数组也可以静态存储在类中。 如果生成的图像具有字符串的“comment”属性，则该字符串将用作此图标的描述。
        参数
        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 - 图像

      • 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

        @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