public interface IIOParamController
GUIを使用してユーザーから値を取得するか、またはほかの手段によって、
IIOParam
オブジェクトの設定値を判定できるオブジェクトにより実装されるインタフェースです。 このインタフェースは、コントローラを呼び出すジェネリック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
を返します。
-
メソッドのサマリー
-
メソッドの詳細
-
activate
boolean activate(IIOParam param) コントローラを呼び出します。true
が返される場合、IIOParam
オブジェクトのすべての設定が、読み込みまたは書込み操作で使用できる状態にあります。false
が返される場合、IIOParam
オブジェクトの設定は影響を受けません。つまり、ユーザーにより操作が取り消されました。- パラメータ:
param
- 変更されるIIOParam
オブジェクト。- 戻り値:
IIOParam
が変更されている場合はtrue
、それ以外の場合はfalse
。- 例外:
IllegalArgumentException
-param
がnull
、または正しいクラスのインスタンスではない場合。
-