Spec-Zone.ru › OpenJDK 21

Класс 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)
Создаёт значок 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()
Возвращает строковое представление этого изображения.

Методы, объявленные в классе 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, 2023, 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/21/docs/api/java.desktop/javax/swing/ImageIcon.html

Spec-Zone.ru

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