Module  java.desktop
软件包  javax.swing

Class ImageIcon

  • All Implemented Interfaces:
    SerializableAccessibleIcon


    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)
        画图标。 图标的左上角的点(被绘制xy在图形上下文的坐标空间) 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​()
        返回此图像的字符串表示形式。
        重写:
        toStringObject
        结果
        表示此图像的字符串
      • 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