javax.imageio
인터페이스 IIOParamController

public interface IIOParamController

객체가 구현하는 인터페이스로 GUI를 준비해 사용자 로부터 값을 얻는 지, 그 외의 방법으로IIOParam 객체의 설정을 확정합니다. 이 인터페이스는 콘트롤러가 값을 얻는 방법으로 관계없이 (즉, 콘트롤러가 GUI를 제공하든가 혹은 단지 값세트를 계산할까는 관계없이), 콘트롤러를 호출하는 범용 activate 메서드를 지정할 뿐입니다.

activate 메서드내에서 콘트롤러는 IIOParam 객체의 get 메서드에 조회해 초기값을 취득해, 모든 수단으로 값을 변경해 IIOParam 객체의 set 메서드를 호출해, 적절한 설정으로 변경합니다. 보통, 이러한 set 메서드는 취소 조작이 기존의 값에 영향을 주지 않게 최종 확정시에 한 번에 호출합니다. 일반적으로는 어플리케이션은 activate 메서드가 true를 돌려줄 때, IIOParam 객체가 읽기 또는 출력조작으로 사용 가능하게 되어 있는 것이라고 보여집니다.

벤더는 특정의 플러그 인을 정의하는 IIOParam 서브 클래스를 위한 GUI를 제공할 수 있습니다. 이것들은 대응하는 IIOParam 서브 클래스에 디폴트 콘트롤러로서 설정할 수 있습니다.

어플리케이션은 디폴트의 GUI를 오버라이드(override) 해, 어플리케이션 자체의 체제에 삽입된 콘트롤러를 제공할 수 있습니다. 여기서 필요한 것은 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 또는 올바른 클래스의 인스턴스가 아닌 경우