javax.swing.text
클래스 InternationalFormatter

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

모든 구현 인터페이스:

Cloneable , Serializable

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

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 가 슬로우 되지 않고 또 그 값이 최대치, 최소치의 범위외인 경우,ParseException 가 슬로우 된다
4. 값이 돌려주어진다

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

경고: 이 클래스의 직렬화 된 오브젝트는 향후의 Swing 의 릴리스와는 호환성을 가지지 않습니다. 현재의 직렬화 서포트는 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. 1.4 에서는 모든 JavaBeans^TM 의 장기 운용 서포트가, 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 를 작성합니다.

메소드의 상세

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 로 설정됩니다.

관련 항목:

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

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

현재가를 String 로 변환할 때에 ParseException 가 슬로우 되는 경우, 텍스트는 하늘의 String 로 설정되어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 - 변환하는 값

반환값:

치의 String 표현

예외:

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

getActions

protected Action [] getActions()

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

오버라이드(override):

클래스 JFormattedTextField.AbstractFormatter 내의 getActions

반환값:

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