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 Version 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 에 인스톨 됩니다.

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

현재의 값을 캐릭터 라인으로 변환할 때 ParseException 가 발생했을 경우는, 텍스트로서 빈 상태(empty)의 캐릭터 라인이 설정되어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 가 throw 됩니다. 단일 인수의 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