Module  java.desktop
软件包  javax.imageio.metadata

Interface IIOMetadataController


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

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

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

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

    另请参见：
    IIOMetadata.setController(javax.imageio.metadata.IIOMetadataController) ， IIOMetadata.getController() ， IIOMetadata.getDefaultController() ， IIOMetadata.hasController() ， IIOMetadata.activateController()

    • 方法详细信息

      • activate

        boolean activate​(IIOMetadata metadata)
        激活控制器。 如果true返回，在所有设置IIOMetadata对象应该是准备在写操作使用。 如果false返回，在没有设置IIOMetadata对象会被干扰（ 也就是说 ，用户取消了该操作）。
        参数
        metadata - 要修改的 IIOMetadata对象。
        结果
        true如果 IIOMetadata已被修改，否则为 false 。
        异常
        IllegalArgumentException - if metadata is null or is not an instance of the correct class.