java.beans
인터페이스 PropertyEditor

기존의 구현 클래스의 일람:

PropertyEditorSupport

public interface PropertyEditor

PropertyEditor 클래스는 유저가 지정의 형태의 프로퍼티치를 편집하기 위한 GUI 의 서포트를 제공합니다.

PropertyEditor 는 프로퍼티치의 표시나 코우신에 도착해 다양한 방법을 서포트합니다. 대부분의 PropertyEditor 에서는 이 API 로 사용할 수 있는 각종 옵션의 부분집합을 서포트하는 것만으로 충분합니다.

단순한 PropertyEditors 가 서포트하는 것은 getAsText 와 setAsText 메소드만으로, paintValue 이나 getCustomEditor 의 서포트는 불필요합니다. 보다 복잡한 것으로는 getAsText 나 setAsText 는 서포트할 수 없습니다만, 대신에 paintValue 과 getCustomEditor 를 서포트합니다.

각 propertyEditor 는 다음의 3 개의 표시 스타일중 1 kr 이상을 반드시 서포트할 필요가 있습니다. 즉, (1) isPaintable 의 서포트, (2) getTags()로부터 null 가 아닌 String[] 를 돌려주어, 한편 getAsText 로부터 null 가 아닌 값을 돌려준다, 또는 (3) 단지 getAsText()로부터 null 가 아닌 String 를 돌려주는 의 3 kr입니다.

각 프로퍼티 에디터는 인수 오브젝트가 대응하는 propertyEditor 의 형태인 경우에, setValue 의 호출을 서포트할 필요가 있습니다. 한층 더 각 프로퍼티 에디터는 커스텀 에디터 또는 setAsText 의 어느 쪽인지를 서포트할 필요가 있습니다.

각 PropertyEditor 는 null constructor를 가지지 않으면 안됩니다.

메소드의 개요

void	addPropertyChangeListener (PropertyChangeListener listener) PropertyChange 이벤트의 청취자를 등록합니다.
String	getAsText () 프로퍼티치를 텍스트로서 취득합니다.
Component	getCustomEditor () PropertyEditor 는 프로퍼티치를 편집하는 완전한 커스텀 컴퍼넌트를 사용할 수 있습니다.
String	getJavaInitializationString () Java 코드를 생성해 프로퍼티치를 설정할 경우에 사용합니다.
String []	getTags () 프로퍼티치가 기존의 태그 첨부의 값세트의 1 개가 아니면 안되는 경우에, 태그의 배열을 돌려줍니다.
Object	getValue () 프로퍼티치를 취득합니다.
boolean	isPaintable () 이 프로퍼티 에디터가 paint 가능한가 어떤가를 판정합니다.
void	paintValue (Graphics gfx, Rectangle box) 값의 표현을 화면의 지정된 area에 표현 합니다.
void	removePropertyChangeListener (PropertyChangeListener listener) PropertyChange 이벤트의 청취자를 삭제합니다.
void	setAsText (String text) 지정된 String (캐릭터 라인)를 해석해 프로퍼티치를 설정합니다.
void	setValue (Object value) 편집되는 오브젝트를 설정 (또는 변경)합니다.
boolean	supportsCustomEditor () 이 프로퍼티 에디터가 커스텀 에디터를 서포트할지 어떨지를 판정합니다.

메소드의 상세

setValue

public void setValue(Object  value)

편집되는 오브젝트를 설정 (또는 변경)합니다. int 등의 원시적형은 대응하는 java.lang.Integer 등의 오브젝트형으로 랩 될 필요가 있습니다.

파라미터:

value - 편집 대상의 새로운 타겟 오브젝트. 이 오브젝트는 PropertyEditor 로 변경하는 것이 아니라, PropertyEditor 로 새로운 오브젝트를 작성해 변경치를 보존한다

getValue

public Object  getValue()

프로퍼티치를 취득합니다.

반환값:

프로퍼티의 값. int 등의 원시적형은 대응하는 java.lang.Integer 등의 오브젝트형으로 랩 될 필요가 있다

isPaintable

public boolean isPaintable()

이 프로퍼티 에디터가 paint 가능한가 어떤가를 판정합니다.

반환값:

클래스가 paintValue 메소드를 받는 경우는 true

paintValue

public void paintValue(Graphics  gfx,
                       Rectangle  box)

값의 표현을 화면의 지정된 area에 표현 합니다. propertyEditor 는 독자적인 클리핑을 실시해, 지정된 구형내에 넣습니다.

PropertyEditor 가 표현 요구를 받아들이지 않는 경우 (isPaintable 를 참조), 이 메소드는 아무것도 실시하지 않습니다.

지정된 Graphics 오브젝트는 친컨테이너의 디폴트의 폰트나 색등을 가지게 됩니다. PropertyEditor 는 폰트나 색등의 그래픽스 속성을 변경하는 일이 있어, 낡은 값을 복원할 필요는 없습니다.

파라미터:

gfx - 표현 되는 그래픽 오브젝트

box - 그래픽 오브젝트를 표현 하는 구형

getJavaInitializationString

public String  getJavaInitializationString()

Java 코드를 생성해 프로퍼티치를 설정할 경우에 사용합니다. 현재의 프로퍼티치를 가지는 변수의 초기화에 사용할 수 있는 Java 코드의 fragment를 돌려줍니다.

결과예로서 「2」, 「new Color(127,127,34)」, 「Color.orange」등이 있습니다.

반환값:

현재가의 초기화자를 나타내는 Java 코드의 fragment

getAsText

public String  getAsText()

프로퍼티치를 텍스트로서 취득합니다.

반환값:

유저가 편집할 수 있는 캐릭터 라인으로 표현된 프로퍼티치

편집 가능한 캐릭터 라인으로서 값을 표현할 수 없는 경우는 null

null 이외의 값이 돌려주어지면(자), PropertyEditor 는 그 캐릭터 라인을 해석해 setAsText()에 되돌린다

setAsText

public void setAsText(String  text)
               throws IllegalArgumentException 

지정된 String (캐릭터 라인)를 해석해 프로퍼티치를 설정합니다. String 의 서식이 부정한 경우, 혹은 프로퍼티를 텍스트 표시할 수 없는 경우는 java.lang.IllegalArgumentException 가 슬로우 됩니다.

파라미터:

text - 해석되는 캐릭터 라인

IllegalArgumentException

getTags

public String [] getTags()

프로퍼티치가 기존의 태그 첨부의 값세트의 1 개가 아니면 안되는 경우에, 태그의 배열을 돌려줍니다. 예를 들어, 이것을 사용해 열거치를 표시할 수 있습니다. PropertyEditor 가 태그를 서포트하는 경우, 값을 설정하는 방법으로서 태그 첨부의 값을 가지는 setAsText 를 사용하거나 현재의 값을 식별하기 위해서 getAsText 를 사용하거나 할 수가 있습니다.

반환값:

이 프로퍼티의 태그 첨부의 값. 이 프로퍼티를 태그 첨부의 값으로 해서 표시할 수 없는 경우는 null

getCustomEditor

public Component  getCustomEditor()

PropertyEditor 는 프로퍼티치를 편집하는 완전한 커스텀 컴퍼넌트를 사용할 수 있습니다. PropertyEditor 는 에디터의 컴퍼넌트와 제휴해, PropertyChange 이벤트를 방아쇠 해 프로퍼티치의 변경을 통지합니다.

getCustomEditor 를 호출하는 고레벨인 코드에서는 컴퍼넌트를 보다 큰 프로퍼티 시트에 짜넣거나 독자적인 다이얼로그에 배치하거나 할 수가 있습니다.

반환값:

유저가 현재의 프로퍼티치를 직접 편집할 수 있게 하는 java.awt.Component. 서포트되지 않는 경우는 null

supportsCustomEditor

public boolean supportsCustomEditor()

이 프로퍼티 에디터가 커스텀 에디터를 서포트할지 어떨지를 판정합니다.

반환값:

propertyEditor 가 커스텀 에디터를 서포트할 수 있는 경우는 true

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener  listener)

PropertyChange 이벤트의 청취자를 등록합니다. PropertyEditor 는 값의 변경시에 프로퍼티명을 null 치로서 이벤트 자체를 소스로서 지정해, 등록되어 모든 PropertyChangeListeners 상에서 PropertyChange 이벤트를 방아쇠 합니다.

파라미터:

listener - PropertyChange 이벤트가 방아쇠 되었을 때에 불려 가는 오브젝트

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener  listener)

PropertyChange 이벤트의 청취자를 삭제합니다.

파라미터:

listener - 삭제되는 PropertyChange 청취자