Module  java.desktop
软件包  javax.swing

Class 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

    • 字段详细信息

      • 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​(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 - 图像

      • 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 - 如果该图标没有图像观察者， 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