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

ZipCodeValidator 클래스에서는, string의 길이와 서식이 5 자리수의 ZIP 코드, 5 자리수 + 4 자리수의 미국 ZIP 코드, 또는 캐나다 우편 번호로서 적절한지 어떤지를 검증합니다.

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

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

 <mx:ZipCodeValidator allowedFormatChars=" -" domain="US Only | US or Canada" invalidCharError="The ZIP code contains invalid characters. " invalidDomainError="The domain parameter is invalid.It must be either 'US Only' or 'US or Canada'. " wrongCAFormatError="The Canadian ZIP code must be formatted 'A1B 2C3'. " wrongLengthError="The ZIP code must be 5 digits or 5+4 digits. " wrongUSFormatError="The ZIP+4 extension must be formatted '12345-6789'. "/> 

View the examples

See also

mx.validators.ZipCodeValidatorDomainType


Public property
 property정의
  allowedFormatChars : String
우편 번호에서 사용할 수 있는 서식 캐릭터세트를 나타냅니다.
ZipCodeValidator
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
  domain : String
체크하는 우편 번호의 종류를 나타냅니다.
ZipCodeValidator
 Inheritedenabled : Boolean
이 값을 false 로 설정하면, 발리 데이터에 의한 검증을 실시할 수 없게 됩니다.
Validator
  invalidCharError : String
우편 번호에 무효인 캐릭터가 포함되는 경우에 발생하는 에러 메세지를 나타냅니다.
ZipCodeValidator
  invalidDomainError : String
domain property에 무효인 값이 포함되는 경우에 발생하는 에러 메세지를 나타냅니다.
ZipCodeValidator
 Inheritedlistener : Object
검증의 listener를 지정합니다.
Validator
 Inheritedproperty : String
검증하는 값을 포함한 source object의 property의 이름을 지정하는 string를 나타냅니다.
Validator
 Inheritedprototype : Object
[static] 클래스 또는 함수 object의 prototype object에의 참조입니다.
Object
 Inheritedrequired : Boolean
true 의 경우, 검증 에러의 원인이 되는 결손치 또는 거짓 가격을 지정합니다.
Validator
 InheritedrequiredFieldError : String
값이 결손해, 게다가 required property가 true 의 경우에 발생하는 에러 메세지입니다.
Validator
 Inheritedsource : Object
검증하는 property를 포함한 object를 지정합니다.
Validator
 Inheritedtrigger : IEventDispatcher
발리 데이터를 방아쇠 하는 이벤트의 생성을 실시하는 컴퍼넌트를 지정합니다.
Validator
 InheritedtriggerEvent : String
검증을 방아쇠 하는 이벤트를 지정합니다.
Validator
  wrongCAFormatError : String
캐나다의 무효인 우편 번호에 대해서 발생하는 에러 메세지를 나타냅니다.
ZipCodeValidator
  wrongLengthError : String
미국의 무효인 우편 번호에 대해서 발생하는 에러 메세지를 나타냅니다.
ZipCodeValidator
  wrongUSFormatError : String
잘못한 서식의 우편 번호에 대해서 발생하는 에러 메세지를 나타냅니다.
ZipCodeValidator
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정의
  ZipCodeValidator ()
constructor   .
ZipCodeValidator
 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
  validateZipCode (validator:ZipCodeValidator , value:Object , baseField:String ):Array
[static] 발리 데이터를 호출하는데 있어서 편리한 Methods입니다.
ZipCodeValidator
 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) 합니다.
ZipCodeValidator
 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의 상세
allowedFormatCharsproperty
allowedFormatChars:String   [read-write]

우편 번호에서 사용할 수 있는 서식 캐릭터세트를 나타냅니다. 수치 또는 알파벳 [a ~ z A ~ Z] 는 지정할 수 없습니다.

디폴트치" -". .

Implements
    public function get allowedFormatChars():String
    public function set allowedFormatChars(value:String ):void
domainproperty 
public var domain:String

체크하는 우편 번호의 종류를 나타냅니다. MXML 에서는, 값 "US or Canada""US Only" 를 지정할 수 있습니다.

ActionScript 에서는, 이 property를 설정하기 위해서 다음의 정수를 사용할 수 있습니다. ZipCodeValidatorDomainType.US_ONLYZipCodeValidatorDomainType.US_OR_CANADA 입니다.

디폴트치ZipCodeValidatorDomainType.US_ONLY.

invalidCharErrorproperty 
public var invalidCharError:String

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

디폴트치"The ZIP code contains invalid characters. ".

invalidDomainErrorproperty 
public var invalidDomainError:String

domain property에 무효인 값이 포함되는 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"The domain parameter is invalid. It must be either 'US Only' or 'US or Canada'. ".

wrongCAFormatErrorproperty 
public var wrongCAFormatError:String

캐나다의 무효인 우편 번호에 대해서 발생하는 에러 메세지를 나타냅니다.

디폴트치"The Canadian postal code must be formatted 'A1B 2C3'. ".

wrongLengthErrorproperty 
public var wrongLengthError:String

미국의 무효인 우편 번호에 대해서 발생하는 에러 메세지를 나타냅니다.

디폴트치"The ZIP code must be 5 digits or 5+4 digits. ".

wrongUSFormatErrorproperty 
public var wrongUSFormatError:String

잘못한 서식의 우편 번호에 대해서 발생하는 에러 메세지를 나타냅니다.

디폴트치"The ZIP+4 code extension must be formatted '12345-6789'. ".

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

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

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

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

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

See also

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

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

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

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

        <mx:Form>
            <mx:FormItem label="Enter a 5 or 9 digit U.S.  Zip code: ">
                <mx:TextInput id="zip" 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/ZipCodeValidator.html