Класс ImageIcon

public class ImageIcon
extends Object
implements Icon, Serializable, Accessible

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

Дополнительную информацию и примеры использования значков изображений см. в разделе Как использовать значки в Руководстве по Java.

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

Поля

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(value="description")
public ImageIcon(String filename)

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

new ImageIcon("images/myImage.gif")

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

Параметры:

filename - строка, определяющая имя файла или путь

См. также:

getDescription()

ImageIcon

public ImageIcon(URL location,
                 String description)

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

Параметры:

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

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

См. также:

ImageIcon(String)

ImageIcon

public ImageIcon(URL location)

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

Параметры:

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

См. также:

getDescription()

ImageIcon

public ImageIcon(Image image,
                 String description)

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

Параметры:

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

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

ImageIcon

public ImageIcon(Image image)

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

Параметры:

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

См. также:

getDescription(), Image.getProperty(java.lang.String, java.awt.image.ImageObserver)

ImageIcon

public ImageIcon(byte[] imageData,
                 String description)

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

Параметры:

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

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

См. также:

Toolkit.createImage(java.lang.String)

ImageIcon

public ImageIcon(byte[] imageData)

Создаёт ImageIcon из массива байтов, прочитанных из файла изображения, содержащего поддерживаемый формат изображения, такой как GIF, JPEG или (с версии 1.3) PNG. Обычно этот массив создаётся при чтении изображения с помощью 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 - изображение

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()

Получает описание изображения. Это предполагается кратким текстовым описанием объекта. Например, это может быть представлено пользователю с нарушениями зрения, чтобы дать представление о назначении изображения. Описание может быть 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

public AccessibleContext getAccessibleContext()

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

Определено в:

getAccessibleContext в интерфейсе Accessible

Возвращает:

AccessibleImageIcon, который служит AccessibleContext этого ImageIcon

С версии:

1.3