javax.imageio
介面 IIOParamController

public interface IIOParamController

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

在 activate 方法中，控制器通過查詢 IIOParam 物件的 get 方法獲得初始值，通過所有的方法修改這些值，然後調用 IIOParam 物件的 set 方法修改適當的設置。通常，在最終提交時，將馬上調用所有這些 set 方法，以便刪除操作不會干擾現有值。總之，應用程序可能期望在 activate 方法返回 true 時，IIOParam 物件已經準備好用於讀取或寫入操作。

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

應用程序可以覆寫任何預設 GUI，提供巢狀在其框架中屬於自己的控制器。需要的所有事物就是 activate 方法有網要地運轉（直到被取消或提交時才返回），儘管不需要提供一個顯式的有網要對話框。這種無網要 GUI 元件大致將按如下方式進行編碼：

 class MyGUI extends SomeComponent implements IIOParamController {

    public MyGUI() {
        // ...
        setEnabled(false);
    }

    public boolean activate(IIOParam param) {
        // disable other components if desired
        setEnabled(true);
        // go to sleep until either cancelled or committed
        boolean ret = false;
        if (!cancelled) {
            // set values on param
            ret = true;
        }
        setEnabled(false);
        // enable any components disabled above
        return ret;
    }
 

作為選擇，可以將演算法過程（比如資料庫尋找或解析命令行）用作控制器，在這種情況下，activate 方法將只尋找或計算設置值、調用 IIOParam.setXXX 方法以及返回 true。

另請參見：

IIOParam.setController(javax.imageio.IIOParamController), IIOParam.getController(), IIOParam.getDefaultController(), IIOParam.hasController(), IIOParam.activateController()

方法摘要

boolean

activate(IIOParam param) 啟動控制器。

方法詳細資訊

activate

boolean activate(IIOParam param)

啟動控制器。如果返回 true，則 IIOParam 物件中的所有設置值都應該已經準備好用於讀取或寫入操作。如果返回 false，則不會干擾 IIOParam 物件中的任何設置值（也就是說，使用者取消了該操作）。

參數：

param - 要修改的 IIOParam 物件。

返回：

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

拋出：

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