Класс ImageIcon

java.lang.Object

javax.swing.ImageIcon

Все реализуемые интерфейсы:: Serializable, Accessible, Icon

public class ImageIcon extends Object implements Icon, Serializable, Accessible

Реализация интерфейса Icon, которая рисует значки из изображений. Изображения, созданные на основе URL, имени файла или массива байтов, предварительно загружаются с помощью MediaTracker, отслеживающего состояние загрузки изображения.

Дополнительные сведения и примеры использования значков изображений см. в разделе Использование значков в Учебнике по Java.

Предупреждение: сериализованные объекты этого класса будут несовместимы с будущими версиями Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4 в пакете java.beans добавлена поддержка долговременного хранения всех JavaBeans. См. XMLEncoder.

Начиная с:: 1.2

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`ImageIcon.AccessibleImageIcon`	Этот класс реализует поддержку специальных возможностей для класса `ImageIcon`.

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected static final Component`	`component`	Устарело. начиная с версии 1.8
`protected static final MediaTracker`	`tracker`	Устарело. начиная с версии 1.8

Краткое описание конструкторов

Конструктор	Описание
`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)`	Создает ImageIcon из указанного URL.
`ImageIcon(URL location, String description)`	Создает ImageIcon из указанного URL.

Краткое описание методов

Модификатор и тип	Метод	Описание
`AccessibleContext`	`getAccessibleContext()`	Возвращает AccessibleContext, связанный с этим ImageIcon.
`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()`	Возвращает строковое представление этого изображения.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Подробное описание полей

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

@ConstructorProperties("description") public ImageIcon(String filename)

Создает ImageIcon из указанного файла. Изображение предварительно загружается с помощью MediaTracker, отслеживающего состояние его загрузки. Указанная строка может содержать имя файла или путь к файлу. При указании пути используйте стандартную для Интернета прямую косую черту ("/") в качестве разделителя. (Строка преобразуется в URL, поэтому прямая косая черта работает во всех системах.) Например, укажите:

   new ImageIcon("images/myImage.gif")

Описание инициализируется строкой filename.

Параметры:

filename — строка, указывающая имя файла или путь

См. также:

ImageIcon

public ImageIcon(URL location, String description)

Создает ImageIcon из указанного URL. Изображение предварительно загружается с помощью MediaTracker, отслеживающего состояние его загрузки.

Параметры:

location — URL изображения

description — краткое текстовое описание изображения

См. также:

ImageIcon

public ImageIcon(URL location)

Создает ImageIcon из указанного URL. Изображение предварительно загружается с помощью MediaTracker, отслеживающего состояние его загрузки. Описание значка инициализируется строковым представлением URL.

Параметры:

location — URL изображения

См. также:

ImageIcon

public ImageIcon(Image image, String description)

Создает ImageIcon из изображения.

Параметры:: image — изображение; description — краткое текстовое описание изображения

ImageIcon

public ImageIcon(Image image)

Создает ImageIcon из объекта изображения. Если у изображения есть свойство "comment" со строковым значением, эта строка используется в качестве описания значка.

Параметры:

image — изображение

См. также:

ImageIcon

public ImageIcon(byte[] imageData, String description)

Создает ImageIcon из массива байтов, считанных из файла изображения, содержащего поддерживаемый формат изображения, например GIF, JPEG или (начиная с версии 1.3) PNG. Обычно этот массив создается путем считывания изображения с помощью Class.getResourceAsStream(), но массив байтов также может быть статически сохранен в классе.

Параметры:

imageData — массив пикселей в формате изображения, поддерживаемом AWT Toolkit, например GIF, JPEG или (начиная с версии 1.3) PNG

description — краткое текстовое описание изображения

См. также:

ImageIcon

public ImageIcon(byte[] imageData)

Параметры:

См. также:

ImageIcon

public ImageIcon()

Создает неинициализированный значок изображения.

Подробное описание методов

loadImage

protected void loadImage(Image image)

Загружает изображение и возвращает управление только после его загрузки.

Параметры:: image — изображение

getImageLoadStatus

public int getImageLoadStatus()

Возвращает состояние операции загрузки изображения.

Возвращает:

состояние загрузки, определенное в java.awt.MediaTracker

См. также:

getImage

public Image getImage()

Возвращает Image этого значка.

Возвращает:: объект Image для этого ImageIcon

setImage

public void setImage(Image image)

Задает изображение, отображаемое этим значком.

Параметры:: image — изображение

getDescription

public String getDescription()

Возвращает описание изображения. Оно предназначено для краткого текстового описания объекта. Например, его можно показать незрячему пользователю, чтобы объяснить назначение изображения. Описание может быть равно null.

Возвращает:: краткое текстовое описание изображения

setDescription

public void setDescription(String description)

Задает описание изображения. Оно предназначено для краткого текстового описания объекта. Например, его можно показать незрячему пользователю, чтобы объяснить назначение изображения.

Параметры:: description — краткое текстовое описание изображения

paintIcon

public void paintIcon(Component c, Graphics g, int x, int y)

Рисует значок. Верхний левый угол значка отображается в точке (x, y) в системе координат графического контекста g. Если у этого значка нет наблюдателя за изображением, данный метод использует компонент c в качестве наблюдателя.

Определено в:: paintIcon в интерфейсе Icon
Параметры:: c — компонент, используемый в качестве наблюдателя, если у значка нет наблюдателя за изображением; g — графический контекст; x — координата X верхнего левого угла значка; y — координата Y верхнего левого угла значка

getIconWidth

public int getIconWidth()

Возвращает ширину значка.

Определено в:: getIconWidth в интерфейсе Icon
Возвращает:: ширину этого значка в пикселях

getIconHeight

public int getIconHeight()

Возвращает высоту значка.

Определено в:: getIconHeight в интерфейсе Icon
Возвращает:: высоту этого значка в пикселях

setImageObserver

public void setImageObserver(ImageObserver observer)

Задает наблюдателя за изображением. Задайте это свойство, если ImageIcon содержит анимированный GIF, чтобы наблюдатель получал уведомления об обновлении изображения. Например:

    icon = new ImageIcon(...)
    button.setIcon(icon);
    icon.setImageObserver(button);

Параметры:: observer — наблюдатель за изображением

getImageObserver

public ImageObserver getImageObserver()

Возвращает наблюдателя за изображением.

Возвращает:: наблюдатель за изображением, который может быть равен null

toString

public String toString()

Возвращает строковое представление этого изображения.

Переопределяет:: toString в классе Object
Возвращает:: строку, представляющую это изображение

getAccessibleContext

@BeanProperty(expert=true, description="The AccessibleContext associated with this ImageIcon.") public AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этим ImageIcon. Для значков изображений AccessibleContext представлен объектом AccessibleImageIcon. При необходимости создается новый экземпляр AccessibleImageIcon.

Определено в:: getAccessibleContext в интерфейсе Accessible
Возвращает:: AccessibleImageIcon, выступающий в роли AccessibleContext этого ImageIcon
Начиная с:: 1.3

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/javax/swing/ImageIcon.html