Module java.desktop
Package javax.imageio.metadata

Interface IIOMetadataController

public interface IIOMetadataController
要由可以确定IIOMetadata对象设置的对象实现的接口，可以通过向用户提供GUI来获取值，或者通过其他方式。该接口仅指定一个通用的activate方法，调用控制器，不考虑控制器如何获取值（即，控制器是通过GUI还是仅计算一组值对于此接口是无关紧要的）。

在activate方法中，控制器通过查询IIOMetadata对象的设置来获取初始值，可以使用XML DOM树或插件特定接口，通过任何方式修改值，然后修改IIOMetadata对象的设置，使用setFromTree或mergeTree方法，或插件特定接口。一般来说，应用程序可以期望当activate方法返回true时，IIOMetadata对象已准备好用于写操作。

供应商可以选择为他们为特定插件定义的IIOMetadata子类提供GUI。这些可以设置为相应IIOMetadata子类中的默认控制器。

或者，可以使用算法过程，如数据库查找或解析命令行作为控制器，此时activate方法将简单查找或计算设置，调用IIOMetadata上的方法来设置其状态，并返回true。

参见:

  • Method Summary

    Modifier and Type
    Method
    Description
    boolean
    activate(IIOMetadata metadata)
    激活控制器。

  • Method Details

    • activate

      boolean activate(IIOMetadata metadata)
      激活控制器。如果返回true，则IIOMetadata对象中的所有设置应准备好用于写操作。如果返回false，则IIOMetadata对象中的任何设置都不会被改变（即，用户取消了操作）。
      参数:
      metadata - 要修改的IIOMetadata对象。
      返回:
      如果IIOMetadata已被修改，则返回true，否则返回false。
      抛出:
      IllegalArgumentException - 如果metadata为null或不是正确类的实例。