javax.swing.text
클래스 DefaultFormatter

java.lang.Object 
  |
  +--javax.swing.JFormattedTextField.AbstractFormatter 
        |
        +--javax.swing.text.DefaultFormatter

모든 구현 인터페이스:

Cloneable , Serializable

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

InternationalFormatter , MaskFormatter

public class DefaultFormatter

extends JFormattedTextField.AbstractFormatter

implements Cloneable , Serializable

DefaultFormatter 는 임의의 오브젝트의 서식 설정을 실시합니다. 서식 설정은 toString 메소드를 호출하는 것으로 실행됩니다. 값을 재차 String 에 변환하기 위해서는 사용하는 클래스에서 String 인수를 취하는 constructor를 제공할 필요가 있습니다. String 를 취하는 단일 인수의 constructor 이 1 개도 발견되지 않는 경우는 stringToValue 에 건네받은 String 가 반환값이 됩니다.

DefaultFormatter 의 인스턴스는 JFormattedTextField 의 복수 인스턴스에서는 사용할 수 없습니다. 구성 끝난 DefaultFormatter 의 카피를 취득하려면 ,clone 메소드를 사용합니다.

경고: 이 클래스의 직렬화 된 오브젝트는 향후의 Swing 의 릴리스와는 호환성을 가지지 않습니다. 현재의 직렬화 서포트는 단기 기억이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. 1.4 에서는 모든 JavaBeans^TM 의 장기 운용 서포트가, java.beans 패키지에 추가되었습니다. XMLEncoder 를 참조해 주세요.

도입된 버젼:

1.4

관련 항목:

javax.swing.JFormattedTextField.AbstractTextFormatter

생성자의 개요

DefaultFormatter ()
DefaultFormatter 를 작성합니다.

메소드의 개요

Object	clone () DefaultFormatter 의 카피를 작성합니다.
boolean	getAllowsInvalid () 편집중의 값을 일정시간 무효로 할 수 있을지 어떨지를 돌려줍니다.
boolean	getCommitsOnValidEdit () 편집이 JFormattedTextField 에 통지되었을 때에 돌려주어집니다.
protected DocumentFilter	getDocumentFilter () JFormattedTextField 에 입력 가능한 캐릭터를 한정하는 DocumentFilter 를 돌려줍니다.
protected NavigationFilter	getNavigationFilter () 커서를 배치 가능한 장소를 한정하는 NavigationFilter 를 돌려줍니다.
boolean	getOverwriteMode () 캐릭터의 삽입시의 동작을 돌려줍니다.
Class	getValueClass () 신규 Object 의 작성에 사용하는 클래스를 돌려줍니다.
void	install (JFormattedTextField ftf) DefaultFormatter 를 특정의 JFormattedTextField 에 인스톨 합니다.
void	setAllowsInvalid (boolean allowsInvalid) 편집중의 값을 일정시간 무효 (즉 stringToValue 가 ParseException 를 슬로우 한다)로 할 수 있을지 어떨지를 설정합니다.
void	setCommitsOnValidEdit (boolean commit) 편집이 JFormattedTextField 에 통지될 때로 설정합니다.
void	setOverwriteMode (boolean overwriteMode) 캐릭터의 삽입시에 동작을 구성합니다.
void	setValueClass (Class valueClass) 신규 Object 의 작성에 사용하는 클래스를 설정합니다.
Object	stringToValue (String string) String 인수를 취하는 constructor 에 의해, 건네받은 String 를 getValueClass 의 인스턴스로 변환합니다.
String	valueToString (Object value) 건네받은 Object 를 toString 메소드를 개입시켜 String 로 변환합니다.

클래스 javax.swing. JFormattedTextField.AbstractFormatter 에서 상속받은 메소드

getActions , getFormattedTextField , invalidEdit , setEditValid , uninstall

클래스 java.lang. Object 에서 상속받은 메소드

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

생성자의 상세

DefaultFormatter

public DefaultFormatter()

DefaultFormatter 를 작성합니다.

메소드의 상세

install

public void install(JFormattedTextField  ftf)

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

서브 클래스가 청취자를 JFormattedTextField 에 추가 인스톨 하는 경우는 통상, 이것을 오버라이드(override) 할 뿐입니다.

현재가를 String 로 변환할 때에 ParseException 가 슬로우 되는 경우, 텍스트는 하늘의 String 로 설정되어JFormattedTextField 는 무효인 상태로서 마크 됩니다.

이것은 public 메소드입니다만, 통상은 JFormattedTextField 의 서브 클래스 에 대해서만 유효합니다. 값이 변경되는지 내부 상태가 변경되는 경우,JFormattedTextField 에 의해 이 메소드가 불려 갑니다.

오버라이드(override):

클래스 JFormattedTextField.AbstractFormatter 내의 install

파라미터:

ftf - 서식 설정용의 JFormattedTextField. null 도 가능 (현행의 JFormattedTextField 의 언인스톨을 나타낸다)

setCommitsOnValidEdit

public void setCommitsOnValidEdit(boolean commit)

편집이 JFormattedTextField 에 통지될 때로 설정합니다. true 의 경우, 유효한 편집 후, 항상 (캐릭터 라인이 편집될 때마다) commitEdit 가 불려 갑니다. 한편, false 의 경우,DefaultFormatter 는 JFormattedTextField 에 편집을 통지하지 않습니다. 이와 같이,JFormattedTextField 의 값이 변경되는 것은 commitEdit 가 JFormattedTextField 상에서 불려 갈 때 뿐이어서, 통상은 Enter 키가 눌렸을 때인가, 포커스가 JFormattedTextField 에 머무르고 있는 경우가 해당합니다.

파라미터:

commit - 편집이 JTextComponent 에 위탁되었을 때를 나타내기 위해서(때문에) 사용된다

getCommitsOnValidEdit

public boolean getCommitsOnValidEdit()

편집이 JFormattedTextField 에 통지되었을 때에 돌려주어집니다.

반환값:

유효한 편집 후에 편집이 위탁되었을 경우는 true

setOverwriteMode

public void setOverwriteMode(boolean overwriteMode)

캐릭터의 삽입시에 동작을 구성합니다. overwriteMode 가 true (디폴트)의 경우, 신규 캐릭터로 모델내의 기존의 캐릭터가 덧쓰기됩니다.

파라미터:

overwriteMode - 덧쓰기 모드(replace mode)가 사용되고 있는지 어떤지를 나타냅니다.

getOverwriteMode

public boolean getOverwriteMode()

캐릭터의 삽입시의 동작을 돌려줍니다.

반환값:

신규에 삽입된 캐릭터가 기존의 캐릭터를 덧쓰기하는 경우는 true

setAllowsInvalid

public void setAllowsInvalid(boolean allowsInvalid)

편집중의 값을 일정시간 무효 (즉 stringToValue 가 ParseException 를 슬로우 한다)로 할 수 있을지 어떨지를 설정합니다. 이것은 무효인 값의 입력을 유저에게 일시적으로 허가하는 경우에 편리한 기능입니다.

파라미터:

allowsInvalid - 편집한 값을 항상 유효하게 할 필요가 있을지 어떨지를 나타내는데 사용된다

getAllowsInvalid

public boolean getAllowsInvalid()

편집중의 값을 일정시간 무효로 할 수 있을지 어떨지를 돌려줍니다.

반환값:

편집한 값을 항상 유효하게 할 필요가 있는 경우는 false

setValueClass

public void setValueClass(Class  valueClass)

신규 Object 의 작성에 사용하는 클래스를 설정합니다. 건네받은 클래스에 String 를 취하는 단일 인수의 constructor 이 없는 경우, String 의 값이 사용됩니다.

파라미터:

valueClass - stringToValue 로부터의 반환값의 구축에 사용하는 클래스

getValueClass

public Class  getValueClass()

신규 Object 의 작성에 사용하는 클래스를 돌려줍니다.

반환값:

stringToValue 로부터의 반환값의 구축에 사용하는 클래스

stringToValue

public Object  stringToValue(String  string)
                     throws ParseException 

String 인수를 취하는 constructor 에 의해, 건네받은 String 를 getValueClass 의 인스턴스로 변환합니다. getValueClass 가 null 를 돌려주는 경우,JFormattedTextField 내의 현행의 값의 Class 가 사용됩니다. 이것이 null 의 경우, String 가 돌려주어집니다. constructor 이 예외를 슬로우 하는 경우는 ParseException 가 슬로우 됩니다. 단일 인수의 String constructor 이 존재하지 않는 경우,string 가 돌려주어집니다.

정의:

클래스 JFormattedTextField.AbstractFormatter 내의 stringToValue

파라미터:

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

반환값:

텍스트의 오브젝트 표현

예외:

ParseException - 변환에 에러가 있는 경우

valueToString

public String  valueToString(Object  value)
                     throws ParseException 

건네받은 Object 를 toString 메소드를 개입시켜 String 로 변환합니다.

정의:

클래스 JFormattedTextField.AbstractFormatter 내의 valueToString

파라미터:

value - 변환하는 값

반환값:

치의 String 표현

예외:

ParseException - 변환에 에러가 있는 경우

getDocumentFilter

protected DocumentFilter  getDocumentFilter()

JFormattedTextField 에 입력 가능한 캐릭터를 한정하는 DocumentFilter 를 돌려줍니다.

오버라이드(override):

클래스 JFormattedTextField.AbstractFormatter 내의 getDocumentFilter

반환값:

편집을 한정하는 DocumentFilter

getNavigationFilter

protected NavigationFilter  getNavigationFilter()

커서를 배치 가능한 장소를 한정하는 NavigationFilter 를 돌려줍니다.

오버라이드(override):

클래스 JFormattedTextField.AbstractFormatter 내의 getNavigationFilter

반환값:

네비게이션을 한정하는 NavigationFilter

clone

public Object  clone()
             throws CloneNotSupportedException 

DefaultFormatter 의 카피를 작성합니다.

오버라이드(override):

클래스 JFormattedTextField.AbstractFormatter 내의 clone

반환값:

DefaultFormatter 의 카피

CloneNotSupportedException