javax.swing
클래스 JFormattedTextField.AbstractFormatter

java.lang.Object 
  javax.swing.JFormattedTextField.AbstractFormatter

모든 구현된 인터페이스:

Serializable

직계의 기존의 서브 클래스:

DefaultFormatter

포함되어 있는 클래스:

JFormattedTextField

public abstract static class JFormattedTextField.AbstractFormatter
extends Object 
implements Serializable 

AbstractFormatter 의 인스턴스는, Object 로부터 String 및 String 로부터 Object 에의 변환을 처리하기 위해서 JFormattedTextField 로 사용됩니다. AbstractFormatter 는, 편집 정책 또는 네비게이션 정책를 강화하거나JFormattedTextField 의 표시 방법을 조작해 필요한 정책를 강화할 수가 있습니다.

AbstractFormatter 는 한 번에 1 개의 JFormattedTextField 만으로 유효합니다. JFormattedTextField 는 사용 준비를 할 수 있었을 때에 install 를 호출해, 사용을 종료하면(자) uninstall 를 호출합니다. 추가 상태를 인스톨 하는 서브 클래스는 필요에 따라서 install 를 오버라이드(override) 해, 상위 클래스에 통지를 실시합니다.

서브 클래스는 변환 메소드의 stringToValue 과 valueToString 를 오버라이드(override) 할 필요가 있습니다. 특정의 방법으로 getActions,getNavigationFilter, 및 getDocumentFilter 를 오버라이드(override) 해,JFormattedTextField 를 제한할 수도 있습니다.

JFormattedTextField 를 일시적으로 무효인 상태로 하는 것을 허가하는 서브 클래스에서는, 적절한 타이밍에 setEditValid 를 호출할 필요가 있습니다.

도입된 버젼:

1.4

생성자 의 개요

JFormattedTextField.AbstractFormatter ()

메소드의 개요

protected Object	clone () AbstractFormatter 를 복제합니다.
protected Action []	getActions () Action 의 커스텀 세트를 제공하는 경우는, 서브 클래스화해 오버라이드(override) 합니다.
protected DocumentFilter	getDocumentFilter () 입력을 제한하는 DocumentFilter 를 제공하는 경우는, 서브 클래스화해, 오버라이드(override) 합니다.
protected JFormattedTextField	getFormattedTextField () AbstractFormatter 가 인스톨 되고 있는 현재의 JFormattedTextField 를 돌려줍니다.
protected NavigationFilter	getNavigationFilter () 사용자의 안내처를 제한하는 필터를 제공하는 경우에 서브 클래스화해, 오버라이드(override) 합니다.
void	install (JFormattedTextField ftf) AbstractFormatter 를 특정의 JFormattedTextField 에 인스톨 합니다.
protected void	invalidEdit () 이것은 사용자가 부정한 문자를 입력했을 때에 불려 갑니다.
protected void	setEditValid (boolean valid) JFormattedTextField 의 editValid 프로퍼티을 갱신하기 위해서 호출합니다.
abstract Object	stringToValue (String text) 임의의 객체를 돌려주는 text 의 구문을 해석합니다.
void	uninstall () JFormattedTextField 에 인스톨 된, 임의 상태의 AbstractFormatter 를 언인스톨합니다.
abstract String	valueToString (Object value) value 를 표시하기 위한 캐릭터 라인치를 돌려줍니다.

클래스 java.lang. Object 로부터 상속된 메소드

equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

생성자 의 상세

JFormattedTextField.AbstractFormatter

public JFormattedTextField.AbstractFormatter()

메소드의 상세

install

public void install(JFormattedTextField  ftf)

AbstractFormatter 를 특정의 JFormattedTextField 에 인스톨 합니다. 이것에 의해 valueToString 가 불려 가, 현재의 값이 JFormattedTextField 로부터 String 에 변환됩니다. 다음에 getActions 로부터의 Action,getDocumentFilter 로부터 반환된 DocumentFilter,getNavigationFilter 로부터 반환된 NavigationFilter 가,JFormattedTextField 에 인스톨 됩니다.

일반적으로, 서브 클래스에서의 오버라이드(override)가 필요하게 되는 것은,JFormattedTextField 에 추가 청취자를 인스톨 하는 경우만입니다.

현재의 값을 캐릭터 라인으로 변환할 때 ParseException 가 발생했을 경우는, 텍스트로서 빈 상태(empty)의 캐릭터 라인이 설정되어JFormattedTextField 에 부정한 상태를 나타내는 값이 설정됩니다.

이것은 public 메소드입니다만, 일반적으로은 JFormattedTextField 의 서브 클래스에 대해서만 유효합니다. 값이 변경되는지, 내부 상태가 변경되는 경우,JFormattedTextField 에 의해 이 메소드가 불려 갑니다. 사용자 자신이 호출할 필요가 있는 것은,JFormattedTextField 를 서브 클래스화하고 있는 경우, 및 AbstractFormatter 를 JFormattedTextField 와는 다른 타이밍에 인스톨 또는 언인스톨하고 있는 경우만입니다.

파라미터:

ftf - 포맷 대상의 JformattedTextField. null 의 경우는, 현재의 JFormattedTextField 로부터의 언인스톨을 나타낸다

uninstall

public void uninstall()

JFormattedTextField 에 인스톨 된, 임의 상태의 AbstractFormatter 를 언인스톨합니다. JFormattedTextField 에 인스톨 된 DocumentFilter,NavigationFilter, 및 추가 Action 가 리셋 됩니다.

stringToValue

public abstract Object  stringToValue(String  text)
                              throws ParseException 

임의의 객체를 돌려주는 text 의 구문을 해석합니다. 포매터에 따라서는 null 가 돌려주어집니다.

파라미터:

text - 변환 대상의 캐릭터 라인

반환값:

텍스트의 객체 표현

예외:

ParseException - 변환으로 에러가 발생했을 경우

valueToString

public abstract String  valueToString(Object  value)
                              throws ParseException 

value 를 표시하기 위한 캐릭터 라인치를 돌려줍니다.

파라미터:

value - 변환 대상의 값

반환값:

치의 캐릭터 라인 표현

예외:

ParseException - 변환으로 에러가 발생했을 경우

getFormattedTextField

protected JFormattedTextField  getFormattedTextField()

AbstractFormatter 가 인스톨 되고 있는 현재의 JFormattedTextField 를 돌려줍니다.

반환값:

포맷 대상의 JFormattedTextField

invalidEdit

protected void invalidEdit()

이것은 사용자가 부정한 문자를 입력했을 때에 불려 갑니다. 호출을 현재의 JFormattedTextField 에 전송 합니다.

setEditValid

protected void setEditValid(boolean valid)

JFormattedTextField 의 editValid 프로퍼티을 갱신하기 위해서 호출합니다. JFormattedTextField 가 항상 유효한 상태이도록(듯이) 포로시를 강화하고 있는 경우는, 호출할 필요는 없습니다.

파라미터:

valid - JformattedTextField 의 유효한 상태

getActions

protected Action [] getActions()

Action 의 커스텀 세트를 제공하는 경우는, 서브 클래스화해 오버라이드(override) 합니다. install 에 의해,JFormattedTextField 의 ActionMap 에 인스톨 됩니다.

반환값:

JformattedTextField 에 인스톨 하는 액션의 배열

getDocumentFilter

protected DocumentFilter  getDocumentFilter()

입력을 제한하는 DocumentFilter 를 제공하는 경우는, 서브 클래스화해, 오버라이드(override) 합니다. install 는, 반환값을 JFormattedTextField 에 인스톨 합니다.

반환값:

편집을 제한하는 DocumentFilter

getNavigationFilter

protected NavigationFilter  getNavigationFilter()

사용자의 안내처를 제한하는 필터를 제공하는 경우에 서브 클래스화해, 오버라이드(override) 합니다. install 는 반환값을 JFormattedTextField 에 인스톨 합니다.

반환값:

네비게이션을 제한하는 NavigationFilter

clone

protected Object  clone()
                throws CloneNotSupportedException 

AbstractFormatter 를 복제합니다. 반환되는 인스턴스는 JFormattedTextField 에는 관련지을 수 없습니다.

오버라이드(override):

클래스 Object 내의 clone

반환값:

AbstractFormatter 의 카피

예외:

CloneNotSupportedException - 객체의 클래스가 Cloneable 인터페이스를 지원하고 있지 않는 경우. clone 메소드를 오버라이드(override) 한 서브 클래스도, 인스턴스를 복제할 수 없는 것을 나타내기 위해서(때문에) 이 예외를 throw 하는 일이 있는

관련 항목:

Cloneable