Spec-Zone.ru › OpenJDK 17

Интерфейс IIOMetadataController

public interface IIOMetadataController
Интерфейс, который должны реализовывать объекты, способные определять настройки объекта IIOMetadata, либо путём отображения графического интерфейса для получения значений от пользователя, либо иными средствами. Данный интерфейс просто определяет универсальный activate метод, который вызывает контроллер, не обращая внимания на то, каким образом контроллер получает значения (т.е., безразлично, отображает ли контроллер графический интерфейс или просто вычисляет набор значений).

Внутри activate метода контроллер получает начальные значения, запросив настройки объекта IIOMetadata, либо с помощью дерева XML DOM, либо с помощью специфичного для плагина интерфейса, изменяет значения любым способом, а затем изменяет настройки объекта IIOMetadata, используя либо setFromTree или mergeTree методы, либо специфичный для плагина интерфейс. В общем случае приложения могут ожидать, что при возврате activate метода значением true, объект IIOMetadata готов к использованию в операции записи.

Поставщики могут выбрать предоставление графических интерфейсов для IIOMetadata подклассов, которые они определяют для конкретного плагина. Эти графические интерфейсы могут быть настроены в качестве контроллеров по умолчанию в соответствующих IIOMetadata подклассах.

В качестве альтернативы, в качестве контроллера может использоваться алгоритмический процесс, такой как поиск в базе данных или обработка командной строки, в этом случае метод activate просто выполнит поиск или вычисление настроек, вызовет методы объекта IIOMetadata для установки его состояния и вернёт значение true.

См. также:
  • IIOMetadata.setController(javax.imageio.metadata.IIOMetadataController)
  • IIOMetadata.getController()
  • IIOMetadata.getDefaultController()
  • IIOMetadata.hasController()
  • IIOMetadata.activateController()

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

Модификатор и тип Метод Описание
boolean activate(IIOMetadata metadata)
Активирует контроллер.

Подробное описание методов

activate

boolean activate(IIOMetadata metadata)
Активирует контроллер. Если возвращается true, все настройки в объекте IIOMetadata должны быть готовы к использованию в операции записи. Если возвращается false, никакие настройки в объекте IIOMetadata не будут изменены (т.е., пользователь отменил операцию).
Параметры:
metadata - объект IIOMetadata, который будет изменён.
Возвращает:
true если IIOMetadata был изменён, false в противном случае.
Выбрасывает:
IllegalArgumentException - если metadata имеет значение null или не является экземпляром правильного класса.

© 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/imageio/metadata/IIOMetadataController.html

Spec-Zone.ru

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