模块 java.desktop
包 javax.imageio.metadata

接口 IIOMetadataController

public interface IIOMetadataController
由可以确定 IIOMetadata 对象设置的对象实现的接口，可以通过建立 GUI 来从用户那里获取值，也可以通过其他方式。该接口仅指定调用控制器的通用activate方法，而不考虑控制器如何获取值（IE, 控制器是提供 GUI 还是仅仅计算一组值与此接口无关)。

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

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

或者，可以将数据库查找或命令行解析等算法过程用作控制器，在这种情况下，activate 方法将简单地查找或计算设置，调用 IIOMetadata 上的方法来设置其状态，然后返回true 。

参见：

  • 方法总结

    修饰符和类型
    方法
    描述
    boolean
    activate(IIOMetadata metadata)
    激活控制器。

  • 方法详情

    • activate

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