Spec-Zone.ru › OpenJDK 17

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

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
END_OF_DOCUMENT_MARKER

toString

public String toString()
Возвращает строковое представление этого изображения.
Overrides:
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, 2021, 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/17/docs/api/java.desktop/javax/swing/ImageIcon.html

Spec-Zone.ru

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