java.beans
인터페이스 PropertyEditor

알려진 구현 클래스 목록:

PropertyEditorSupport

public interface PropertyEditor

PropertyEditor 클래스는 사용자가 지정의 형태의 프로퍼티치를 편집하기 위한 GUI 지원를 제공합니다.

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

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

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

각 프로퍼티 에디터는 인수 객체가 대응하는 propertyEditor 형태인 경우에 setValue 호출을 지원할 필요가 있습니다. 또한 각 프로퍼티 에디터는 커스텀 에디터 또는 setAsText 어느 쪽인지를 지원할 필요가 있습니다.

각 PropertyEditor는 null 생성자를 가지지 않으면 안됩니다.

메서드 개요

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

메서드의 상세

setValue

void setValue(Object  value)

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

파라미터:

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

getValue

Object  getValue()

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

반환값:

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

isPaintable

boolean isPaintable()

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

반환값:

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

paintValue

void paintValue(Graphics  gfx,
                Rectangle  box)

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

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

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

파라미터:

gfx - 렌더링 되는 그래픽 객체

box - 그래픽 객체를 렌더링 하는 구형

getJavaInitializationString

String  getJavaInitializationString()

Java 코드의 단편을 리턴합니다. 이 단편을 사용해, 에디터의 현재 상태에 일치하는 프로퍼티를 설정할 수 있습니다. 이 메서드는 프로퍼티 에디터에 한 변경을 반영하는 목적으로 Java 코드를 생성할 경우에 사용됩니다.

코드의 단편은 컨텍스트에 존하지 않는 JLS 지정의 Java 정규 표현으로 합니다.

특히, 이 표현 (식)이 계산식의 경우, 모든 클래스 및 static 멤버를 완전 수식명으로 지정할 필요가 있습니다. 이 규칙은 생성자, static 메서드 및 비원시적 인수에 적용됩니다.

이 표현 (식)을 평가할 때는 예외가 Throw 될 가능성에 주의해 주세요. 특히, 코드의 작성자는 확인이 끝난 예외를 Throw 할지도 모르는 표현이 있는 경우에 생성된 코드가 확실히 컴파일 되도록 주의해 주세요.

결과예를 나타냅니다.

• 원시적식: 2
• 클래스 constructor　 　: new java.awt.Color(127,127,34)
• static 필드: java.awt.Color.orange
• static 메서드: javax.swing.Box.createRigidArea(new java.awt.Dimension(0, 5))

반환값:

현재의 값의 초기화자를 나타내는 Java 코드의 단편. 식의 말미에 세미콜론 ( 「;」)을 사용해서는 안 된다

getAsText

String  getAsText()

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

반환값:

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

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

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

setAsText

void setAsText(String  text)
               throws IllegalArgumentException 

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

파라미터:

text - 해석되는 캐릭터 라인

예외:

IllegalArgumentException

getTags

String [] getTags()

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

반환값:

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

getCustomEditor

Component  getCustomEditor()

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

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

반환값:

사용자가 현재의 프로퍼티치를 직접 편집할 수 있도록 하는 java.awt.Component. 지원되지 않는 경우는 null

supportsCustomEditor

boolean supportsCustomEditor()

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

반환값:

propertyEditor가 커스텀 에디터를 지원할 수 있는 경우는 true

addPropertyChangeListener

void addPropertyChangeListener(PropertyChangeListener  listener)

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

파라미터:

listener - PropertyChange 이벤트가 트리거 되었을 때에 호출되는 객체

removePropertyChangeListener

void removePropertyChangeListener(PropertyChangeListener  listener)

PropertyChange 이벤트의 리스너를 삭제합니다.

파라미터:

listener - 삭제되는 PropertyChange 리스너