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

StringValidator 클래스에서는, string의 길이가 지정의 범위내인가 어떤가를 검증합니다.

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

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

 <mx:StringValidator maxLength="NaN" minLength="NaN" tooLongError="This string is longer than the maximum allowed length. " tooShortError="This string is shorter than the minimum allowed length. "/> 

View the examples



Public property
 property정의
 Inheritedconstructor : Object
특정의 object 인스턴스의 클래스 object 또는 constructor    함수에의 참조입니다.
Object
 Inheritedenabled : Boolean
이 값을 false 로 설정하면, 발리 데이터에 의한 검증을 실시할 수 없게 됩니다.
Validator
 Inheritedlistener : Object
검증의 listener를 지정합니다.
Validator
  maxLength : Number
유효한 string의 최대의 길이를 나타냅니다.
StringValidator
  minLength : Number
유효한 string의 최소의 길이를 나타냅니다.
StringValidator
 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
  tooLongError : String
string의 길이가 maxLength property의 값보다 큰 경우에 발생하는 에러 메세지를 나타냅니다.
StringValidator
  tooShortError : String
string의 길이가 minLength property의 값보다 작은 경우에 발생하는 에러 메세지를 나타냅니다.
StringValidator
 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정의
  StringValidator ()
constructor   .
StringValidator
 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
  validateString (validator:StringValidator , value:Object , baseField:String = null):Array
[static] 발리 데이터를 호출하는데 있어서 편리한 Methods입니다.
StringValidator
 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
string를 검증하는데 있어서 기본 클래스의 doValidation() Methods를 재정의(override) 합니다.
StringValidator
 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의 상세
maxLengthproperty
public var maxLength:Number

유효한 string의 최대의 길이를 나타냅니다. 값이 NaN 의 경우, 이 property는 무시됩니다.

디폴트치NaN.

minLengthproperty 
public var minLength:Number

유효한 string의 최소의 길이를 나타냅니다. 값이 NaN 의 경우, 이 property는 무시됩니다.

디폴트치NaN.

tooLongErrorproperty 
tooLongError:String   [read-write]

string의 길이가 maxLength property의 값보다 큰 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"This String is longer than the maximum allowed length. ".

Implements
    public function get tooLongError():String
    public function set tooLongError(value:String ):void
tooShortErrorproperty 
tooShortError:String   [read-write]

string의 길이가 minLength property의 값보다 작은 경우에 발생하는 에러 메세지를 나타냅니다.

디폴트치"This String is shorter than the minimum allowed length. ".

Implements
    public function get tooShortError():String
    public function set tooShortError(value:String ):void
constructor    의 상세
StringValidator()constructor   
public 함수 StringValidator()

constructor   .

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

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

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

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

반환값
Array — ValidationResult object의 배열입니다. 이 object는, 검증을 하는 필드 마다 1 개 포함됩니다.
validateString()Methods 
public static function validateString(validator:StringValidator , value:Object , baseField:String = null):Array

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

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

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

See also

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

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

    <mx:StringValidator source="{fname}" property="text" 
        tooShortError="This string is shorter than the minimum allowed length of 4.  " 
        tooLongError="This string is longer than the maximum allowed length of 20. " 
        minLength="4" maxLength="20"  
        trigger="{myButton}" triggerEvent="click" 
        valid="Alert.show('Validation Succeeded! ');"/>

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

            <mx:Form>               
                <mx:FormItem label="Enter a name between 4 and 20 characters: ">
                    <mx:TextInput id="fname" 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/StringValidator.html