This page was saved using jaction on 2006-09-04 8:33:55.
Address: http://flexdocs.kr/docs/flex2/langref/mx/validators/NumberValidator.html
Title: mx.validators.NumberValidator (Flex™ 2 레퍼런스 가이드)  •  Size: 68068
Packagemx.validators
Classpublic class NumberValidator
InheritanceNumberValidator Inheritance Validator Inheritance EventDispatcher Inheritance Object

NumberValidator 클래스는, string가 유효한 수치일지 어떨지를 확인합니다. 이 클래스에서는, 입력치가 특정의 범위 (minValue 및 maxValue 로 지정)에 들어가고 있는 것, 정수인 것 (domain 로 지정), 부의 수치가 아닌 것 (allowNegative 로 지정), 및 표시되는 자리수가 지정한 precision 를 넘지 않는 것확인할 수 있습니다. 이 발리 데이터에서는,"12,345.67" 과 같이 형식화 된 수치를 정확하게 검증합니다. thousandsSeparator property 및 decimalSeparator property는, 국제화에 대응해 customize 할 수 있습니다.

MXML 문장구조법expandedMXML 문장구조법의 비표시

<mx:NumberValidator> 태그는, Super 클래스의 모든 태그 속성을 Inheritance해, 다음의 태그 속성을 추가합니다. 

 <mx:NumberValidator allowNegative="true|false" decimalPointCountError="The decimal separator can only occur once. " decimalSeparator=". " domain="real|int" exceedsMaxError="The number entered is too large. " integerError="The number must be an integer. " invalidCharError="The input contains invalid characters. " invalidFormatCharsError="One of the formatting parameters is invalid. " lowerThanMinError="The number entered is too small. " maxValue="NaN" minValue="NaN" negativeError="The number may not be negative. " precision="-1" precisionError="The number entered has too many digits beyond the decimal point. " separationError="The thousands separator must be followed by three digits. " thousandsSeparator="," />

View the examples


Public property
 property정의
  allowNegative : Boolean
부의 수치가 사용 가능한가 어떤가를 지정합니다.
NumberValidator
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor　 　 함수에의 참조입니다.
Object
  decimalPointCountError : String
소수점의 기호를 복수개 포함한 경우에 발생하는 에러 메세지를 나타냅니다.
NumberValidator
  decimalSeparator : String
소수부를 단락짓는 캐릭터를 나타냅니다.
NumberValidator
  domain : String
검증하는 수치의 형태를 나타냅니다.
NumberValidator
 Inheritedenabled : Boolean
이 값을 false 로 설정하면, 발리 데이터에 의한 검증을 실시할 수 없게 됩니다.
Validator
  exceedsMaxError : String
값이 maxValue property의 값을 초과하는 경우에 발생하는 에러 메세지를 나타냅니다.
NumberValidator
  integerError : String
domain property로 수치형에 정수를 지정할 필요가 있는 경우에 발생하는 에러 메세지를 나타냅니다.
NumberValidator
  invalidCharError : String
값에 무효인 캐릭터가 포함되어 있는 경우에 발생하는 에러 메세지를 나타냅니다.
NumberValidator
  invalidFormatCharsError : String
값에 무효인 형식의 캐릭터가 포함되는 경우에 발생하는 에러 메세지를 나타냅니다. 구체적으로는, 단락 캐릭터에 숫자 또는 마이너스 기호 (-)가 사용되고 있는 경우, 혹은 단락지어 캐릭터가 복수개 연속해 사용되고 있는 경우가 거기에 해당합니다.
NumberValidator
 Inheritedlistener : Object
검증의 listener를 지정합니다.
Validator
  lowerThanMinError : String
값이 minValue 미만의 경우에 발생하는 에러 메세지를 나타냅니다.
NumberValidator
  maxValue : Number
유효한 수치의 최대치를 나타냅니다.
NumberValidator
  minValue : Number
유효한 수치의 최소치를 나타냅니다.
NumberValidator
  negativeError : String
부의 값으로, 게다가 allowNegative property가 false 의 경우에 발생하는 에러 메세지를 나타냅니다.
NumberValidator
  precision : int
소수부의 최대 자리수를 나타냅니다.
NumberValidator
  precisionError : String
값이, precision property로 정의되고 있는 자리수를 넘는 경우에 발생하는 에러 메세지를 나타냅니다.
NumberValidator
 Inheritedproperty : String
검증하는 값을 포함한 source object의 property의 이름을 지정하는 string를 나타냅니다.
Validator
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
 Inheritedrequired : Boolean
true 의 경우, 검증 에러의 원인이 되는 결손치 또는 거짓 가격을 지정합니다.
Validator
 InheritedrequiredFieldError : String
값이 결손해, 게다가 required property가 true 의 경우에 발생하는 에러 메세지입니다.
Validator
  separationError : String
자리수 단락 기호가 잘못한 위치에 놓여져 있는 경우에 발생하는 에러 메세지를 나타냅니다.
NumberValidator
 Inheritedsource : Object
검증하는 property를 포함한 object를 지정합니다.
Validator
  thousandsSeparator : String
수치의 정수부를 3 자리수 마다 단락짓는데 사용하는 캐릭터를 나타냅니다.
NumberValidator
 Inheritedtrigger : IEventDispatcher
발리 데이터를 방아쇠 하는 이벤트의 생성을 실시하는 컴퍼넌트를 지정합니다.
Validator
 InheritedtriggerEvent : String
검증을 방아쇠 하는 이벤트를 지정합니다.
Validator
Protected property
 property정의
 InheritedactualListeners : Array
listener objects가 존재하는 경우는 listener objects를 포함합니다. 그렇지 않은 경우는, 소스 object를 포함합니다.
Validator
 InheritedactualTrigger : IEventDispatcher
방아쇠 object가 존재하는 경우는 방아쇠 object를 포함합니다. 그렇지 않은 경우는, 소스 object를 포함합니다.
Validator
 InheritedsubFields : Array
validate() Methods에게 건네진 value object에 포함되는 property명을 포함한 string의 배열입니다.
Validator
Public Methods
 Methods정의
  NumberValidator ()
constructor　 　.
NumberValidator
 InheritedaddEventListener (type:String , listener:Function , useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
event listener objects를 EventDispatcher object에 등록해, listener가 이벤트의 통지를 받도록(듯이) 합니다.
EventDispatcher
 InheriteddispatchEvent (event:Event ):Boolean
이벤트를 event 플로우(flow)에 dispatch합니다.
EventDispatcher
 InheritedhasEventListener (type:String ):Boolean
EventDispatcher object에, 특정의 event 타입에 대해서 등록된 listener가 있을지 어떨지를 확인합니다.
EventDispatcher
 InheritedhasOwnProperty (name:String ):Boolean
object로 지정된 property가 정의되고 있는지 어떤지를 나타냅니다.
Object
 Inheritedinitialized (document:Object , id:String ):void
MXML 태그를 사용해 발리 데이터를 작성했을 때에, MXML 컴파일러에 의해 자동적으로 불려 갑니다.
Validator
 InheritedisPrototypeOf (theClass:Object ):Boolean
Object 클래스의 인스턴스가, Parameters로서 지정된 object의 prototype 체인내에 있을지 어떨지를 나타냅니다.
Object
 InheritedpropertyIsEnumerable (name:String ):Boolean
지정된 property가 존재해, 열거 가능한가 어떤가를 나타냅니다.
Object
 InheritedremoveEventListener (type:String , listener:Function , useCapture:Boolean = false):void
EventDispatcher object로부터 listener를 삭제합니다.
EventDispatcher
 InheritedsetPropertyIsEnumerable (name:String , isEnum:Boolean = true):void
루프 처리에 대한 다이나믹 property의 가용성을 설정합니다.
Object
 InheritedtoString ():String
지정된 object의 string 표현을 돌려줍니다.
Object
 Inheritedvalidate (value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent
검증을 실행해, 그 결과의 listener를 임의로 통지합니다.
Validator
 InheritedvalidateAll (validators:Array ):Array
[static] validators 배열에 포함되는 모든 발리 데이터를 호출합니다.
Validator
  validateNumber (validator:NumberValidator , value:Object , baseField:String ):Array
[static] custom 검증 함수로부터 발리 데이터를 호출하는 편리한 Methods입니다.
NumberValidator
 InheritedvalueOf ():Object
지정된 object의 원시적치를 돌려줍니다.
Object
 InheritedwillTrigger (type:String ):Boolean
지정된 event 타입에 대해, 이 EventDispatcher object 또는 그 조상에게 event listener가 등록되어 있는지 어떤지를 확인합니다.
EventDispatcher
Protected Methods
 Methods정의
 InheritedaddListenerHandler ():void
발리 데이터로부터 dispatch된 valid event 및 invalid 이벤트의 모든 listener를 설정합니다.
Validator
  doValidation (value:Object ):Array
수치를 검증하는데 있어서 기본 클래스의 doValidation() Methods를 재정의(override) 합니다.
NumberValidator
 InheritedgetValueFromSource ():Object
검증하는 object를 돌려줍니다.
Validator
 InheritedhandleResults (errorResults:Array ):ValidationResultEvent
에러 결과의 배열로부터 ValidationResultEvent 를 돌려줍니다.
Validator
  isRealValue (value:Object ):Boolean
값이 null 가 아니고, NaN 값가 아닌지 어떤지를 지정합니다.
NumberValidator
 InheritedremoveListenerHandler ():void
발리 데이터로부터 dispatch된 valid event 및 invalid 이벤트의 모든 listener를 절단 합니다.
Validator
이벤트
 이벤트일람정의
 Inheritedinvalid 검증이 실패하면 dispatch됩니다. Validator
 Inheritedvalid 검증이 정상적으로 완료하면 dispatch됩니다. Validator
Protected 정수
 정수정의
 InheritedDECIMAL_DIGITS : String = "0123456789"
[static] 0 에서 9 의 10 진수자를 포함한 string입니다.
Validator
 InheritedROMAN_LETTERS : String = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz"
[static] 로마자 알파벳의 대문자와 소문자를 포함한 string입니다 ("A" 로부터 "Z", 및 "a" 로부터 "z").
Validator
property의 상세
allowNegativeproperty
public var allowNegative:Boolean

부의 수치가 사용 가능한가 어떤가를 지정합니다. 유효한 값은,true 또는 false 입니다.

디폴트치true.

decimalPointCountErrorproperty 
public var decimalPointCountError:String

소수점의 기호를 복수개 포함한 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"The decimal separator can only occur once. ".

decimalSeparatorproperty 
public var decimalSeparator:String

소수부를 단락짓는 캐릭터를 나타냅니다. 숫자는 사용하지 못하고,thousandsSeparator 와는 다른 string로 할 필요가 있습니다.

디폴트치". ".

domainproperty 
public var domain:String

검증하는 수치의 형태를 나타냅니다. 지정할 수 있는 값은,"real" 및 "int" 입니다.

디폴트치"real".

exceedsMaxErrorproperty 
public var exceedsMaxError:String

값이 maxValue property의 값을 초과하는 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"The number entered is too large. ".

integerErrorproperty 
public var integerError:String

domain property로 수치형에 정수를 지정할 필요가 있는 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"The number must be an integer. ".

invalidCharErrorproperty 
public var invalidCharError:String

값에 무효인 캐릭터가 포함되어 있는 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치The input contains invalid characters. ".

invalidFormatCharsErrorproperty 
public var invalidFormatCharsError:String

값에 무효인 형식의 캐릭터가 포함되는 경우에 발생하는 에러 메세지를 나타냅니다. 구체적으로는, 단락 캐릭터에 숫자 또는 마이너스 기호 (-)가 사용되고 있는 경우, 혹은 단락지어 캐릭터가 복수개 연속해 사용되고 있는 경우가 거기에 해당합니다.

디폴트치"One of the formatting parameters is invalid. ".

lowerThanMinErrorproperty 
public var lowerThanMinError:String

값이 minValue 미만의 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"The number entered is too small. ".

maxValueproperty 
public var maxValue:Number

유효한 수치의 최대치를 나타냅니다. 값이 NaN 의 경우, 최대치가 없는 것을 의미합니다.

디폴트치NaN.

minValueproperty 
public var minValue:Number

유효한 수치의 최소치를 나타냅니다. 값이 NaN 의 경우, 최소치가 없는 것을 의미합니다.

디폴트치NaN.

negativeErrorproperty 
public var negativeError:String

부의 값으로, 게다가 allowNegative property가 false 의 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"The number may not be negative. ".

precisionproperty 
public var precision:int

소수부의 최대 자리수를 나타냅니다. 부 이외의 임의의 정수를 설정할 수 있습니다. 메모:0 으로 설정하면,domain 를 "int" 로 설정하는 경우와 같은 효과가 있습니다. 값이 -1 의 경우, 값은 무시됩니다.

디폴트치-1.

precisionErrorproperty 
public var precisionError:String

값이, precision property로 정의되고 있는 자리수를 넘는 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"The number entered has too many digits beyond the decimal point. ".

separationErrorproperty 
public var separationError:String

자리수 단락 기호가 잘못한 위치에 놓여져 있는 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"The thousands separator must be followed by three digits. ".

thousandsSeparatorproperty 
public var thousandsSeparator:String

수치의 정수부를 3 자리수 마다 단락짓는데 사용하는 캐릭터를 나타냅니다. 숫자는 사용하지 못하고,decimalSeparator 와는 다른 string로 할 필요가 있습니다.

디폴트치",".

constructor　 　 의 상세
NumberValidator()constructor　 　
public 함수 NumberValidator()

constructor　 　.

Methods의 상세
doValidation()Methods
protected override function doValidation(value:Object ):Array

수치를 검증하는데 있어서 기본 클래스의 doValidation() Methods를 재정의(override) 합니다.

이 Methods는 유저가 직접 호출하는 것은 아니고, 타당성을 검증할 때에 Flex 로부터 불려 갑니다. Validator 클래스를 커스텀으로 작성하는 경우는, 이 Methods를 Implements할 필요가 있습니다.

Parameters
value:Object — 검증하는 object입니다.

반환값
Array — ValidationResult object의 배열입니다. 이 object는, 검증을 하는 필드 마다 1 개 포함됩니다.
isRealValue()Methods 
protected override function isRealValue(value:Object ):Boolean

값이 null 가 아니고, NaN 값가 아닌지 어떤지를 지정합니다.

Parameters
value:Object

반환값
Boolean
validateNumber()Methods 
public static function validateNumber(validator:NumberValidator , value:Object , baseField:String ):Array

custom 검증 함수로부터 발리 데이터를 호출하는 편리한 Methods입니다. 다른 표준 Flex 발리 데이터에도 각각 같은 편리한 Methods가 있습니다.

Parameters
validator:NumberValidator — NumberValidator 인스턴스를 나타냅니다.
 
value:Object — 검증하는 필드를 나타냅니다.
 
baseField:String — value Parameters로 지정한 subfield의 텍스트의 형태를 나타냅니다. 예를 들어,value Parameters로 value.number 를 지정하는 경우,baseField 의 값은 "number" 입니다.

반환값
Array — ValidationResult object의 배열입니다. 이 object는, 검증을 하는 필드 마다 1 개 포함됩니다.

See also

mx.validators.ValidationResult
Examples
NumberValidatorExample
<? xml version="1.0" encoding="utf-8"? >
<! -- Simple example to demonstrate the NumberValidator.  -->
<mx:Application xmlns:mx="http://www.adobe.com/2006/mxml">

    <mx:Script>
        import mx.controls.Alert;
    </mx:Script>

    <mx:NumberValidator source="{age}" property="text" integerError="Enter Integer value"
        minValue="18" maxValue="50" domain="int" 
        trigger="{myButton}" triggerEvent="click"
        valid="Alert.show('Validation Succeeded! ');"/>

    <mx:Panel title="NumberValidator Example" width="75%" height="75%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">

        <mx:Form>
            <mx:FormItem label="Enter an age between 18 and 50: ">
                <mx:TextInput id="age" width="100%"/>
            </mx:FormItem>

            <mx:FormItem >
                <mx:Button id="myButton" label="Validate" />
            </mx:FormItem>
        </mx:Form>
    </mx:Panel>
</mx:Application>



© 2004-2006 Adobe Systems Incorporated. All rights reserved.
2006.08. 17, 오후 11:21, GMT-07:00


 

코멘트가 추가되었을 경우, 메일로 받기. | 코멘트 리포트

현재의 페이지: http://flexdocs.kr/docs/flex2/langref/mx/validators/NumberValidator.html