javax.imageio.metadata

Interface IIOMetadataController

public interface IIOMetadataController

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

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

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

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

另请参见：

IIOMetadata.setController(javax.imageio.metadata.IIOMetadataController) ， IIOMetadata.getController() ， IIOMetadata.getDefaultController() ， IIOMetadata.hasController() ， IIOMetadata.activateController()

方法摘要

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

方法详细信息

activate

boolean activate(IIOMetadata metadata)

激活控制器。 如果返回true ，则IIOMetadata对象中的所有设置都应准备好用于写入操作。 如果返回false ，则IIOMetadata对象中的任何设置都不会受到干扰（ 即用户取消操作）。

参数

metadata - 要修改的 IIOMetadata对象。

结果

true如果 IIOMetadata已被修改， false false。

异常

IllegalArgumentException - if metadata is null or is not an instance of the correct class.