Spec-Zone.ru › OpenJDK 24

Класс 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, добавлена поддержка долгосрочного хранения всех JavaBeans в пакете java.beans. Пожалуйста, обратитесь к 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)
Создаёт значок изображения из массива байтов, прочитанных из файла изображения, содержащего поддерживаемый формат изображения, такой как 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, связанный с этим 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()
Возвращает строковое представление этого изображения.

Методы, объявленные в классе 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. Установите этот параметр, если ImageIcon содержит анимированный GIF, чтобы наблюдатель уведомлялся об обновлении отображения. Например: 
     icon = new ImageIcon(...)
     button.setIcon(icon);
     icon.setImageObserver(button);
Parameters:
observer - наблюдатель за изображением

getImageObserver

public ImageObserver getImageObserver()
Возвращает наблюдателя за изображением.
Returns:
наблюдатель за изображением, может быть null

toString

public String toString()
Возвращает строковое представление этого изображения.
Overrides:
toString в классе Object
Returns:
строковое представление этого изображения

getAccessibleContext

@BeanProperty(expert=true, description="The AccessibleContext associated with this ImageIcon.") public AccessibleContext getAccessibleContext()
Получает AccessibleContext, связанный с этим ImageIcon. Для значков изображений AccessibleContext принимает вид AccessibleImageIcon. Новый экземпляр AccessibleImageIcon создается при необходимости.
Specified by:
getAccessibleContext в интерфейсе Accessible
Returns:
AccessibleImageIcon, который служит AccessibleContext для этого ImageIcon
Since:
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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/swing/ImageIcon.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API