javax.imageio.metadata
인터페이스 IIOMetadataController

public interface IIOMetadataController

GUI를 사용해 사용자 로부터 값을 얻는 지, 또는 다른 수단에의해 IIOMetadata 객체의 설정치를 판정할 수 있는 객체에 의해 구현되는 인터페이스입니다. 이 인터페이스는 콘트롤러를 호출하는 범용 activate 메서드를 지정하는 것만으로 있어, 콘토라가 값을 얻는 방법에 대해서는 고려하지 않습니다 (즉, 콘트롤러가 GUI를 사용하는지, 일련의 값을 계산할 뿐 화도인가는 이 인터페이스에는 관계 없습니다).

activate 메서드내에서 콘트롤러는 XML DOM 트리 또는 플러그 인 고유의 인터페이스를 사용해, IIOMetadata 객체의 설정치를 조회해 초기값을 취득해, 어떠한 방법으로 값을 변경합니다. 다음에 setFromTree 또는 mergeTree 메서드, 혹은 플러그 인 고유의 인터페이스를 사용은 IIOMetadata 객체의 설정치를 변경합니다. 일반적으로 어플리케이션은, activate 메서드가 true를 돌려주는 경우, IIOMetadata객체는 출력조작에 사용할 준비가 되어 있으면 상정하는 경우가 있습니다.

벤더는 특정의 플러그 인용으로 정의하는 IIOMetadata 서브 클래스의 GUI를 제공하는 경우가 있습니다. 이것들은 대응하는 IIOMetadata 서브 클래스의 디폴트의 콘트롤러로서 설정할 수 있습니다 .

또는 데이타베이스 룩 업이나 커멘드행의 해석등의 알고리즘 처리는 콘트롤러로서 사용할 수 있어 그 경우, 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인지, 올바른 클래스의 인스턴스가 아닌 경우