Класс ImageIcon

Все реализованные интерфейсы:
Serializable, Accessible, Icon 
public class ImageIcon
extends Object
implements Icon, Serializable, Accessible

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

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

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

С:
1.2
См. также:
Сериализованная форма

Вложенные классы

Модификатор и тип Класс Описание
protected class  ImageIcon.AccessibleImageIcon

Этот класс реализует поддержку доступности для класса ImageIcon.

Поля

Модификатор и тип Поле Описание
protected static Component component

Устарело.

с 1.8
protected static MediaTracker tracker

Устарело.

с 1.8

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

Конструктор Описание
ImageIcon()

Создаёт неинициализированный значок изображения.
ImageIcon​(byte[] imageData)

Создаёт значок изображения из массива байтов, прочитанных из файла изображения, содержащего поддерживаемый формат изображения, например GIF, JPEG или (начиная с 1.3) PNG.
ImageIcon​(byte[] imageData, String description)

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

Создаёт значок изображения из объекта изображения.
ImageIcon​(Image image, String description)

Создаёт значок изображения из изображения.
ImageIcon​(String filename)

Создаёт значок изображения из указанного файла.
ImageIcon​(String filename, String description)

Создаёт значок изображения из указанного файла.
ImageIcon​(URL location)

Создаёт значок изображения из указанного URL.
ImageIcon​(URL location, String description)

Создаёт значок изображения из указанного URL.

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

Модификатор и тип Метод Описание
AccessibleContext getAccessibleContext()

Возвращает AccessibleContext, связанный с этим значком изображения.
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()

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

Методы, объявленные в классе java.lang.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(String)

ImageIcon

@ConstructorProperties("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 Toolkit, таком как 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 Toolkit, таком как 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

@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, 2020, 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/11/docs/api/java.desktop/javax/swing/ImageIcon.html

Spec-Zone .ru
спецификации, руководства, описания, API