Spec-Zone.ru › OpenJDK 21

Интерфейс IIOMetadataController

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

Внутри метода activate, контроллер получает начальные значения, запрашивая настройки объекта IIOMetadata, используя дерево DOM XML или интерфейс, специфичный для плагина, изменяет значения любым способом, затем изменяет настройки объекта 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, 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/imageio/metadata/IIOMetadataController.html

Spec-Zone.ru

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