javax.imageio.metadata
介面 IIOMetadataController

public interface IIOMetadataController

該介面將由可以確定 IIOMetadata 物件設置值（通過提供一個 GUI 來從使用者那裡獲取值或其他方式）的物件實作。此介面只指定調用控制器的一般 activate 方法，不考慮該控制器獲得值的方式（也就是說，該控制器是提供一個 GUI 還是只計算一個值的集合與此介面無關）。

在 activate 方法中，控制器通過查詢 IIOMetadata 物件的設置（使用 XML DOM 階層樹或特定於外掛程式的介面）獲取初始值，通過所有方法修改值，然後再使用 setFromTree 或 mergeTree 方法抑或特定於外掛程式的介面修改 IIOMetadata 物件的設置值。通常，應用程序可能期望在 activate 方法返回 true 時，IIOMetadata 物件已經準備好用於寫入操作。

供應商可以選擇為他們針對特定外掛程式定義的 IIOMetadata 子類別提供 GUI。其可以作為相應 IIOParam 子類別中的預設控制器。

作為選擇，可以將演算法過程（比如資料庫尋找或解析命令行）用作控制器，在這種情況下，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 物件。

返回：

如果已經修改了 IIOMetadata，則返回 true，否則返回 false。

拋出：

IllegalArgumentException - 如果 metadata 為 null 或者不是正確類別的實例。