JavaTM 2
Platform
Std.  Ed.  v1. 4.0

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 에서는 모든 JavaBeansTM 의 장기 운용 서포트가, 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)
          편집중의 값을 일정시간 무효 (즉 stringToValueParseException 를 슬로우 한다)로 할 수 있을지 어떨지를 설정합니다.
 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 의 경우,DefaultFormatterJFormattedTextField 에 편집을 통지하지 않습니다. 이와 같이,JFormattedTextField 의 값이 변경되는 것은 commitEditJFormattedTextField 상에서 불려 갈 때 뿐이어서, 통상은 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)
편집중의 값을 일정시간 무효 (즉 stringToValueParseException 를 슬로우 한다)로 할 수 있을지 어떨지를 설정합니다. 이것은 무효인 값의 입력을 유저에게 일시적으로 허가하는 경우에 편리한 기능입니다.

파라미터:
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

JavaTM 2
Platform
Std.  Ed.  v1. 4.0

버그의 보고와 기능의 리퀘스트
이외의 API 레퍼런스 및 개발자용 문서에 대해서는 Java 2 SDK SE 개발자용 문서를 참조해 주세요. 개발자전용의 상세한 해설, 개념의 개요, 용어의 정의, 버그의 회피책, 및 코드 실례가 포함되어 있습니다.

Java, Java 2 D, 및 JDBC 는 미국 및 그 외의 나라에 있어서의 미국 Sun Microsystems, Inc. 의 상표 혹은 등록상표입니다.
Copyright 1993-2002 Sun Microsystems, Inc. 901 San Antonio Road
Palo Alto, California, 94303, U.S.A. All Rights Reserved.