javax.swing.text
클래스 InternationalFormatter

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

모든 구현된 인터페이스:

Serializable, Cloneable

알려진 직계 서브 클래스:

DateFormatter, NumberFormatter

public class InternationalFormatter
extends DefaultFormatter 

InternationalFormatter는 String 에의 변환과 String 로부터의 변환을 처리하는 java.text.Format 인스턴스를 사용해, DefaultFormatter를 확장합니다.

getAllowsInvalid()가 false인 경우, 각 편집의 현행 텍스트에 서식을 붙이도록 Format에 요구합니다.

setMinimum 메서드와 setMaximum 메서드로 최소값와 최대값을 지정할 수 있습니다. 이것을 유효하게 하려면, stringToValue로 부터 리턴된 값이, Comparable인터페이스를 개입시켜 최대값 /최소값와 비교 가능하지 않으면 안됩니다.

특정의 값이 입력 불가가 된다고 하는 상황을 만들어 내는 일이 있기 때문에 Format와 InternationalFormatter 구성 방법에는 주의가 필요합니다. 항상 유효한 InternationalFormatter (setAllowsInvalid(false))인 날짜와 시간 서식 「M/d/yy」가 덧쓰기 모드(replace mode) (setOverwriteMode(true))이며, 날짜와 시간는 7/1/99 이다고 합니다. 이 경우 사용자는 2 자리수의 달 및 날짜와 시간를 입력할 수 없습니다. 이것을 회피하려면, 서식을 「MM/dd/yy」로 할 필요가 있습니다.

InternationalFormatter가 유효한 값 (setAllowsInvalid(false))만을 허가하도록 구성되어 있는 경우, 유효한 각 편집은, Format로 부터 완전하게 리셋 된 JFormattedTextField 텍스트가 됩니다. 또 커서 위치는 리터럴 문자가 결과의 String에 대해서 추가 또는 삭제되도록 조정됩니다.

stringToValue InternationalFormatter 동작은, DefaultTextFormatter 동작과는 조금 다릅니다. 이 경우는 이하를 실행합니다.

1. parseObject는 setFormat로 지정된 Format 상에서 불려 간다
2. Class가 그 값으로 설정되면 (setValueClass), 슈퍼 클래스의 구현이 불려가 parseObject로 부터 리턴된 값을 적절한 클래스로 변환한다
3. ParseException가 Throw 되지 않고, 또 그 값이 최대값, 최소값의 범위외인 경우, ParseException가 Throw 된다
4. 값이 리턴된

Format이 돌려주는 대체 Class를 지정하려면, InternationalFormatter가 이 방법으로 stringToValue를 구현합니다.

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

도입된 버전 :

1.4

관련 항목:

Format, Comparable

생성자 개요

InternationalFormatter ()
Format를 지정하지 않고, InternationalFormatter를 작성합니다.

InternationalFormatter (Format format)
지정한 Format인스턴스를 사용해, InternationalFormatter를 작성합니다.

메서드 개요

Object	clone () DefaultFormatter 복사본을 작성합니다.
protected Action []	getActions () getSupportsIncrement이 true를 돌려주는 경우, 값의 증감에 적절한, 2개의 Action가 리턴됩니다 .
Format.Field []	getFields (int offset) offset에 서의 텍스트에 관련된 Format.Field 정수를 리턴합니다.
Format	getFormat () 편집, 표시가 가능한 정당한 값을 규정하는 서식을 리턴합니다.
Comparable	getMaximum () 가능한 최대값을 리턴합니다.
Comparable	getMinimum () 가능한 최소값을 리턴합니다.
void	install (JFormattedTextField ftf) DefaultFormatter를 특정의 JFormattedTextField에 인스톨 합니다.
void	setFormat (Format format) 편집 및 표시가 가능한 정당한 값을 규정하는 서식을 설정합니다.
void	setMaximum (Comparable max) 가능한 최대값을 설정합니다.
void	setMinimum (Comparable minimum) 가능한 최소값을 설정합니다.
Object	stringToValue (String text) String text Object 표현을 리턴합니다.
String	valueToString (Object value) Object value String 표현을 리턴합니다.

클래스 javax.swing.text. DefaultFormatter 로부터 상속된 메서드

getAllowsInvalid, getCommitsOnValidEdit, getDocumentFilter, getNavigationFilter, getOverwriteMode, getValueClass, setAllowsInvalid, setCommitsOnValidEdit, setOverwriteMode, setValueClass

클래스 javax.swing. JFormattedTextField.AbstractFormatter 로부터 상속된 메서드

getFormattedTextField, invalidEdit, setEditValid, uninstall

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

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

생성자 상세

InternationalFormatter

public InternationalFormatter()

Format를 지정하지 않고, InternationalFormatter를 작성합니다.

InternationalFormatter

public InternationalFormatter(Format  format)

지정한 Format인스턴스를 사용해, InternationalFormatter를 작성합니다.

파라미터:

format - String와 의 상호 변환에 사용되는 Format 인스턴스

메서드의 상세

setFormat

public void setFormat(Format  format)

편집 및 표시가 가능한 정당한 값을 규정하는 서식을 설정합니다.

파라미터:

format - String와 의 상호 변환에 사용되는 Format인스턴스

getFormat

public Format  getFormat()

편집, 표시가 가능한 정당한 값을 규정하는 서식을 리턴합니다.

반환값:

String와 의 상호 변환에 사용되는 Format 인스턴스

setMinimum

public void setMinimum(Comparable  minimum)

가능한 최소값을 설정합니다. valueClass가 미지정으로 minimum가 null 이외의 경우, valueClass는 minimum 클래스의 valueClass로 설정됩니다.

파라미터:

minimum - 입력 가능한 최소 적정치

관련 항목:

DefaultFormatter.setValueClass(java.lang.Class)

getMinimum

public Comparable  getMinimum()

가능한 최소값을 리턴합니다.

반환값:

입력 가능한 최소 적정치

setMaximum

public void setMaximum(Comparable  max)

가능한 최대값을 설정합니다. valueClass가 미지정으로max가 null 이외의 경우, valueClass는 max 클래스의 valueClass로 설정됩니다.

파라미터:

max - 입력 가능한 최대 적정치

관련 항목:

DefaultFormatter.setValueClass(java.lang.Class)

getMaximum

public Comparable  getMaximum()

가능한 최대값을 리턴합니다.

반환값:

입력 가능한 최대 적정치

install

public void install(JFormattedTextField  ftf)

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

보통, 서브 클래스에서의 오버라이드(override)가 필요하게 되는 것은, JFormattedTextField에 추가 리스너를 인스톨 하는 경우만입니다.

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

이것은 public 메서드입니다만, 일반적으로 JFormattedTextField 서브 클래스에 대해서만 유효합니다. 값이 변경되는지, 내부 상태가 변경되는 경우, JFormattedTextField에 의해 이 메서드가 호출됩니다.

오버라이드(override):

클래스 DefaultFormatter 내의 install

파라미터:

ftf - 서식 설정용의 JformattedTextField. null인 경우는 현재의 JFormattedTextField 로부터의 언인스톨을 나타낸다

valueToString

public String  valueToString(Object  value)
                     throws ParseException 

Object value String 표현을 리턴합니다. 이것에 의해 현재의 Format 상에서 format이 호출됩니다.

오버라이드(override):

클래스 DefaultFormatter 내의 valueToString

파라미터:

value - 변환 대상의 값

반환값:

치의 캐릭터 라인 표현

예외:

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

stringToValue

public Object  stringToValue(String  text)
                     throws ParseException 

String text Object 표현을 리턴합니다.

오버라이드(override):

클래스 DefaultFormatter 내의 stringToValue

파라미터:

text - 변환하는 String

반환값:

텍스트의 Object 표현

예외:

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

getFields

public Format.Field [] getFields(int offset)

offset에 서의 텍스트에 관련된 Format.Field 정수를 리턴합니다. offset 위값이 현재의 텍스트내에서 부정한 경우는 비어있는 배열이 리턴됩니다 .

파라미터:

offset - 검사하는 텍스트에의 오프셋(offset)

반환값:

지정된 위치의 텍스트에 관련한 Format.Field 정수

clone

public Object  clone()
             throws CloneNotSupportedException 

DefaultFormatter 복사본을 작성합니다.

오버라이드(override):

클래스 DefaultFormatter 내의 clone

반환값:

DefaultFormatter 카피

예외:

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

관련 항목:

Cloneable

getActions

protected Action [] getActions()

getSupportsIncrement이 true를 돌려주는 경우, 값의 증감에 적절한, 2개의 Action가 리턴됩니다 .

오버라이드(override):

클래스 JFormattedTextField.AbstractFormatter 내의 getActions

반환값:

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