javax.swing.text
클래스 NumberFormatter

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

모든 구현 인터페이스:

Cloneable , Serializable

public class NumberFormatter

extends InternationalFormatter

NumberFormatter 는 수에 관한 특수한 동작을 추가하는 InternationalFormatter 를 서브 클래스화합니다. 특수화에는 이하가 포함됩니다 (이것들은 setAllowsInvalid(false) 와 같이,NumberFormatter 가 무효인 수를 표시하지 않는 경우에만 사용된다).

• 지수 필드 이외의 필드에서 +/- ( 「-」은 DecimalFormat 에 관련하는 DecimalFormatSymbols 로부터 판별된다)를 누르면(자), 수의 부호의 정/부에의 변경이 시도된다
• 지수 필드에서 +/- ( 「-」은DecimalFormat 에 관련하는 DecimalFormatSymbols 로부터 판별된다)를 누르면(자), 지수의 부호의 정/부에의 변경이 시도된다

과학적 수치 표기를 사용하고 있는 경우는 덧쓰기 모드(replace mode) setOverwriteMode(true) 를 온으로 합니다. 다음에 예를 나타냅니다.

 DecimalFormat decimalFormat = new DecimalFormat("0.000E0");
 NumberFormatter textFormatter = new NumberFormatter(decimalFormat);
 textFormatter.setOverwriteMode(true);
 textFormatter.setAllowsInvalid(false);
 

유저에게 10 진수치의 입력을 허가하는 경우, DecimalFormat 에 적어도 1 개의 10 진수 (#. 0###)(을)를 갖게하는지 무효인 setAllowsInvalid(true) 가 되는 값을 허가할 필요가 있습니다. 그렇지 않은 경우, 유저는 10 진수치를 입력할 수 없습니다.

NumberFormatter 에서는 슈퍼 클래스와는 조금 다른 동작을 stringToValue 에 제공합니다. Class 에,Integer,Long,stringToValue Float,Double,Byte,Short 중 어떤 것인가의 값을 지정하고 있어, Format 의 parseObject 가 Number 의 인스턴스를 돌려주는 경우, 값클래스의 대응하는 인스턴스는 값클래스가 나타내는 원시적형에 적절한 constructor를 사용해 작성됩니다. 예를 들어,setValueClass(Integer.class) 는 결과적으로 new Integer(((Number) formatter.parseObject(string)). intValue()) 로 작성되는 값이 됩니다. 전형적인 예로서 다양한 Number 의 구현이 일반적으로 서로끼리를 비교할 수 없을 때에, 최대치나 최소치를 설정하는데 도움이 됩니다. 또, 뭔가의 이유로써 값에 특별한 Number 의 구현이 필요한 때에도 도움이 됩니다.

경고: 이 클래스의 직렬화 된 오브젝트는 향후의 Swing 의 릴리스와는 호환성을 가지지 않습니다. 현재의 직렬화 서포트는 단기간의 운용이나, 같은 버젼의 Swing 를 실행하는 어플리케이션간의 RMI 에 적절하고 있습니다. 1.4 에서는 모든 JavaBeans^TM 의 장기 운용 서포트가, java.beans 패키지에 추가되었습니다. XMLEncoder 를 참조해 주세요.

도입된 버젼:

1.4

생성자의 개요

NumberFormatter ()
NumberFormat.getNumberInstance() 로부터 취득한 디폴트의 NumberFormat 인스턴스를 사용해 NumberFormatter 를 작성합니다.

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

메소드의 개요

void	setFormat (Format format) 편집 및 표시가 가능한 정당한 값을 규정하는 서식을 설정합니다.

클래스 javax.swing.text. InternationalFormatter 에서 상속받은 메소드

clone , getActions , getFields , getFormat , getMaximum , getMinimum , install , setMaximum , setMinimum , stringToValue , valueToString

클래스 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

생성자의 상세

NumberFormatter

public NumberFormatter()

NumberFormat.getNumberInstance() 로부터 취득한 디폴트의 NumberFormat 인스턴스를 사용해 NumberFormatter 를 작성합니다.

NumberFormatter

public NumberFormatter(NumberFormat  format)

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

파라미터:

format - 정당한 값의 규정에 사용하는 서식

메소드의 상세

setFormat

public void setFormat(Format  format)

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

null 의 constructor를 사용했을 경우, 이 프로퍼티의 값은 NumberFormat.getNumberInstance() 메소드에 의해 현재의 로케일로 결정됩니다.

오버라이드(override):

클래스 InternationalFormatter 내의 setFormat

파라미터:

format - 적정한 값의 규정에 사용하는 NumberFormat 인스턴스