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;
    }
 

또, 데이타베이스 look 업 또는 커멘드행의 해석등의 알고리즘 프로세스를, 콘트롤러로서 사용할 수도 있습니다. 이 경우,activate 메소드는 설정을 검색할까 계산을 실시하는 것만으로,IIOParam.setXXX 메소드를 호출해 true 를 돌려줍니다.

관련 항목:

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

메소드의 개요

boolean

activate (IIOParam param) 콘트롤러를 호출합니다.

메소드의 상세

activate

public boolean activate(IIOParam  param)

콘트롤러를 호출합니다. true 가 돌려주어지는 경우,IIOParam 오브젝트의 모든 설정이, 읽어들여 또는 기입해 조작으로 사용할 수 있는 상태에 있습니다. false 가 돌려주어지는 경우,IIOParam 오브젝트의 설정은 아무것도 영향을 받지 않습니다. 즉, 유저가 조작을 취소했다고 하는 것이 됩니다.

파라미터:

param - 변경되는 IIOParam 오브젝트

반환값:

IIOParam 가 변경되고 있는 경우는 true, 그렇지 않은 경우는 false

예외:

IllegalArgumentException - param 가 null 또는 올바른 클래스의 인스턴스가 아닌 경우