javax.swing.text
클래스 DefaultFormatter

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

모든 구현된 인터페이스:

Serializable, Cloneable

알려진 직계 서브 클래스:

InternationalFormatter, MaskFormatter

public class DefaultFormatter
extends JFormattedTextField.AbstractFormatter 
implements Cloneable,
 Serializable 

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

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

경고: 이 클래스의 직렬화 된 객체는 향후의 Swing 릴리즈와 호환되지 않을 예정입니다. 현재의 직렬화의 지원은 단기간의 운용이나, 같은 버전의 Swing를 실행하는 어플리케이션간의 RMI에 적절하고 있습니다. JDK 버전 1.4 이후, 모든 JavaBeans^™ 장기간의 운용 지원은 java.beans 패키지에 추가되고 있습니다. 자세한 내용은 XMLEncoder를 참조하십시오.

도입된 버전 :

1.4

관련 항목:

JFormattedTextField.AbstractFormatter

생성자 개요

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을 Throw 한다)로 할 수 있을지 어떨지를 설정합니다.
void	setCommitsOnValidEdit (boolean commit) 편집이 JFormattedTextField에 통지될 때로 설정합니다.
void	setOverwriteMode (boolean overwriteMode) 문자의 삽입시에 동작을 구성합니다.
void	setValueClass (Class <? > valueClass) 새로운 Object 작성에 사용하는 클래스를 설정합니다.
Object	stringToValue (String string) String 인수를 취하는 생성자에의해 건네받은 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을 Throw 한다)로 할 수 있을지 어떨지를 설정합니다. 이것은 무효인 값의 입력을 사용자에 게 일시적으로 허가하는 경우에 편리한 기능입니다.

파라미터:

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

getAllowsInvalid

public boolean getAllowsInvalid()

편집중의 값을 일정시간 무효로 할 수 있을지 어떨지를 리턴합니다.

반환값:

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

setValueClass

public void setValueClass(Class <? > valueClass)

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

파라미터:

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

getValueClass

public Class <? > getValueClass()

새로운 Object 작성에 사용하는 클래스를 리턴합니다.

반환값:

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

stringToValue

public Object  stringToValue(String  string)
                     throws ParseException 

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

정의:

클래스 JFormattedTextField.AbstractFormatter 내의 stringToValue

파라미터:

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

반환값:

텍스트의 객체 표현

예외:

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

valueToString

public String  valueToString(Object  value)
                     throws ParseException 

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

정의:

클래스 JFormattedTextField.AbstractFormatter 내의 valueToString

파라미터:

value - 변환 대상의 값

반환값:

치의 캐릭터 라인 표현

예외:

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 - 객체의 클래스가 Cloneable인터페이스를 지원 하고 있지 않는 경우. clone 메서드를 오버라이드(override) 한 서브 클래스도, 인스턴스를 복제할 수 없는 것을 나타내기 위해서 이 예외를 Throw 하는 일이 있는

관련 항목:

Cloneable