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

CurrencyValidator 클래스는, string가 유효한 통화의 식인 것을 확인합니다. 이 클래스에서는, 입력치가 특정의 범위 (minValuemaxValue 로 지정)에 들어가고 있는 것, 부의 수치가 아닌 것 (allowNegative 로 지정), 및 표시되는 자리수가 지정한 precision 를 넘지 않는 것을 확인할 수 있습니다. CurrencyValidator 클래스는,"$12, 345.00" 과 같이 포맷이 적용되고 있는 통화로도, 또 "12345" 와 같이 형식이 적용되지 않은 통화로도, 정확하게 검증합니다. currencySymbol,alignSymbol,thousandsSeparator, 및 decimalSeparator 의 각 property는, 국제화에 대응해 customize 할 수 있습니다.

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

<mx:CurrencyValidator> 태그는, 그 Super 클래스의 모든 태그 property를 Inheritance해, 다음파티를 추가합니다.

 <mx:CurrencyValidator alignSymbol="left|right|any" allowNegative="true|false" currencySymbol="$" currencySymbolError="The currency symbol occurs in an invalid location. " decimalPointCountError="The decimal separator can only occur once. " decimalSeparator=". " exceedsMaxError="The amount entered is too large. " invalidCharError="The input contains invalid characters. " invalidFormatCharsError="One of the formatting parameters is invalid. " lowerThanMinError="The amount entered is too small. " maxValue="NaN" minValue="NaN" negativeError="The amount may not be negative. " precision="2" precisionError="The amount entered has too many digits beyond the decimal point. " separationError="The thousands separator must be followed by three digits. " thousandsSeparator="," /> 

View the examples

See also

mx.validators.CurrencyValidatorAlignSymbol


Public property
 property정의
  alignSymbol : String
식의 나머지의 부분을 기준으로 한 currencySymbol 의 정렬 설정을 지정합니다.
CurrencyValidator
  allowNegative : Boolean
부의 수치가 사용 가능한가 어떤가를 지정합니다.
CurrencyValidator
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  currencySymbol : String
"$" (이)나 "£" 등, 통화 기호의 지정에 사용하는 단일 캐릭터 string를 나타냅니다.
CurrencyValidator
  currencySymbolError : String
currencySymbol 로 정의한 통화 기호가 잘못한 장소에 있는 경우에 발생하는 에러 메세지를 나타냅니다.
CurrencyValidator
  decimalPointCountError : String
소수점의 기호를 복수개 포함한 경우에 발생하는 에러 메세지를 나타냅니다.
CurrencyValidator
  decimalSeparator : String
소수부를 단락짓는 캐릭터를 나타냅니다.
CurrencyValidator
 Inheritedenabled : Boolean
이 값을 false 로 설정하면, 발리 데이터에 의한 검증을 실시할 수 없게 됩니다.
Validator
  exceedsMaxError : String
값이 maxValue 를 넘는 경우에 발생하는 에러 메세지를 나타냅니다.
CurrencyValidator
  invalidCharError : String
통화에 무효인 캐릭터가 포함되어 있는 경우에 발생하는 에러 메세지를 나타냅니다.
CurrencyValidator
  invalidFormatCharsError : String
값에 무효인 서식 캐릭터가 포함되는 경우에 발생하는 에러 메세지를 나타냅니다.
CurrencyValidator
 Inheritedlistener : Object
검증의 listener를 지정합니다.
Validator
  lowerThanMinError : String
값이 minValue 미만의 경우에 발생하는 에러 메세지를 나타냅니다.
CurrencyValidator
  maxValue : Number
유효한 수치의 최대치를 나타냅니다.
CurrencyValidator
  minValue : Number
유효한 수치의 최소치를 나타냅니다.
CurrencyValidator
  negativeError : String
부의 값으로, 게다가 allowNegative property가 false 의 경우에 발생하는 에러 메세지를 나타냅니다.
CurrencyValidator
  precision : int
소수부의 최대 자리수를 나타냅니다.
CurrencyValidator
  precisionError : String
값이,precisionproperty로 정의되고 있는 자리수를 넘는 경우에 발생하는 에러 메세지를 나타냅니다.
CurrencyValidator
 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
자리수 단락 기호가 잘못한 장소에 배치되고 있는 경우에 발생하는 에러 메세지를 나타냅니다.
CurrencyValidator
 Inheritedsource : Object
검증하는 property를 포함한 object를 지정합니다.
Validator
  thousandsSeparator : String
자리수 단락에 사용되는 캐릭터를 나타냅니다.
CurrencyValidator
 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정의
  CurrencyValidator ()
constructor   .
CurrencyValidator
 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
  validateCurrency (validator:CurrencyValidator , value:Object , baseField:String ):Array
[static] 발리 데이터를 호출하는데 있어서 편리한 Methods입니다.
CurrencyValidator
 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) 합니다.
CurrencyValidator
 InheritedgetValueFromSource ():Object
검증하는 object를 돌려줍니다.
Validator
 InheritedhandleResults (errorResults:Array ):ValidationResultEvent
에러 결과의 배열로부터 ValidationResultEvent 를 돌려줍니다.
Validator
 InheritedisRealValue (value:Object ):Boolean
value 가 null 의 경우,true 를 돌려줍니다.
Validator
 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의 상세
alignSymbolproperty
public var alignSymbol:String

식의 나머지의 부분을 기준으로 한 currencySymbol 의 정렬 설정을 지정합니다. ActionScript 로 지정할 수 있는 값은,CurrencyValidatorAlignSymbol.LEFT,CurrencyValidatorAlignSymbol.RIGHT, 및 CurrencyValidatorAlignSymbol.ANY 입니다. MXML 로 지정할 수 있는 값은,"left","right", 및 "any" 입니다.

디폴트치CurrencyValidatorAlignSymbol.LEFT.

See also

allowNegativeproperty 
public var allowNegative:Boolean

부의 수치가 사용 가능한가 어떤가를 지정합니다. true 또는 false 를 지정할 수 있습니다.

디폴트치true.

currencySymbolproperty 
public var currencySymbol:String

"$" (이)나 "£" 등, 통화 기호의 지정에 사용하는 단일 캐릭터 string를 나타냅니다. 숫자는 사용하지 못하고,thousandsSeparatordecimalSeparator 와는 다른 string로 할 필요가 있습니다.

디폴트치"$".

currencySymbolErrorproperty 
public var currencySymbolError:String

currencySymbol 로 정의한 통화 기호가 잘못한 장소에 있는 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"The currency symbol occurs in an invalid location. ".

decimalPointCountErrorproperty 
public var decimalPointCountError:String

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

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

decimalSeparatorproperty 
public var decimalSeparator:String

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

디폴트치". ".

exceedsMaxErrorproperty 
public var exceedsMaxError:String

값이 maxValue 를 넘는 경우에 발생하는 에러 메세지를 나타냅니다.

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

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 amount 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 amount may not be negative. ".

precisionproperty 
public var precision:int

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

디폴트치2.

precisionErrorproperty 
public var precisionError:String

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

디폴트치"The amount 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

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

디폴트치",".

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

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 개 포함됩니다.
validateCurrency()Methods 
public static function validateCurrency(validator:CurrencyValidator , value:Object , baseField:String ):Array

발리 데이터를 호출하는데 있어서 편리한 Methods입니다. 다른 표준 Flex 발리 데이터에도 각각 같은 편리한 Methods가 있습니다.

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

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

See also

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

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

    <mx:CurrencyValidator source="{priceUS}" property="text" precision="2" 
        trigger="{myButton}" triggerEvent="click" 
        valid="Alert.show('Validation Succeeded! ');"/>

    <mx:Panel title="CurrencyValidator Example" width="75%" height="75%" 
        paddingTop="10" paddingLeft="10" paddingRight="10" paddingBottom="10">
        
        <mx:Form>
            <mx:FormItem label="Enter a U.S.  dollar amount: ">
                 <mx:TextInput id="priceUS" width="100%"/>
            </mx:FormItem>

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






 

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

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