Paket | mx.validators |
Klass | public class DateValidator |
Arv | DateValidator Validator EventDispatcher Object |
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
- The month is between 1 and 12 (or 0-11 for
Date
objects) - The day is between 1 and 31
- The year is a number
You can specify the date in the DateValidator class in two ways:
- Single String containing the date - Use the
source
andproperty
properties to specify the String. The String can contain digits and the formatting characters specified by theallowedFormatChars
property, which include the "/\-. " characters. By default, the input format of the date in a String field is "MM/DD/YYYY" where "MM" is the month, "DD" is the day, and "YYYY" is the year. You can use theinputFormat
property to specify a different format. -
Date
object. - Object or multiple fields containing the day, month, and year.
Use all of the following properties to specify the day, month,
and year inputs:
daySource
,dayProperty
,monthSource
,monthProperty
,yearSource
, andyearProperty
.
The <mx:DateValidator>
tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:DateValidator allowedFormatChars="/\-. " dayListener="Object specified by daySource" dayProperty="No default" daySource="No default" formatError= "Configuration error: Incorrect formatting string." inputFormat="MM/DD/YYYY" invalidCharError="The date contains invalid characters." monthListener="Object specified by monthSource" monthProperty="No default" monthSource="No default" validateAsString="true|false" wrongDayError="Enter a valid day for the month." wrongLengthError="Type the date in the format inputFormat." wrongMonthError="Enter a month between 1 and 12." wrongYearError="Enter a year between 0 and 9999." yearListener="Object specified by yearSource" yearProperty="No default" yearSource="No default" />
Egenskap | Definieras med | ||
---|---|---|---|
allowedFormatChars : String
The set of formatting characters allowed for separating
the month, day, and year values. | DateValidator | ||
constructor : Object
En referens till klassobjektet eller konstruktorfunktionen för en given objektinstans. | Object | ||
dayListener : IValidatorListener
The component that listens for the validation result
for the day subfield. | DateValidator | ||
dayProperty : String
Name of the day property to validate. | DateValidator | ||
daySource : Object
Object that contains the value of the day field. | DateValidator | ||
enabled : Boolean
Setting this value to false will stop the validator
from performing validation. | Validator | ||
formatError : String
Error message when the inputFormat property
is not in the correct format. | DateValidator | ||
inputFormat : String
The date format to validate the value against. | DateValidator | ||
invalidCharError : String
Error message when there are invalid characters in the date. | DateValidator | ||
listener : Object
Specifies the validation listener. | Validator | ||
monthListener : IValidatorListener
The component that listens for the validation result
for the month subfield. | DateValidator | ||
monthProperty : String
Name of the month property to validate. | DateValidator | ||
monthSource : Object
Object that contains the value of the month field. | DateValidator | ||
property : String
A String specifying the name of the property
of the source object that contains
the value to validate. | Validator | ||
required : Boolean = true
If true, specifies that a missing or empty
value causes a validation error. | Validator | ||
requiredFieldError : String
Error message when a value is missing and the
required property is true. | Validator | ||
source : Object
Specifies the object containing the property to validate. | Validator | ||
trigger : IEventDispatcher
Specifies the component generating the event that triggers the validator. | Validator | ||
triggerEvent : String
Specifies the event that triggers the validation. | Validator | ||
validateAsString : Object
Determines how to validate the value. | DateValidator | ||
wrongDayError : String
Error message when the day is invalid. | DateValidator | ||
wrongLengthError : String
Error message when the length of the date
doesn't match that of the inputFormat property. | DateValidator | ||
wrongMonthError : String
Error message when the month is invalid. | DateValidator | ||
wrongYearError : String
Error message when the year is invalid. | DateValidator | ||
yearListener : IValidatorListener
The component that listens for the validation result
for the year subfield. | DateValidator | ||
yearProperty : String
Name of the year property to validate. | DateValidator | ||
yearSource : Object
Object that contains the value of the year field. | DateValidator |
Metod | Definieras med | ||
---|---|---|---|
Constructor. | DateValidator | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registrerar ett händelseavlyssnarobjekt för ett EventDispatcher-objekt så att avlyssnaren får meddelanden om händelser. | EventDispatcher | ||
Skickar en händelse till händelseflödet. | EventDispatcher | ||
Kontrollerar om EventDispatcher-objektet har några avlyssnare registrerade för en viss typ av händelse. | EventDispatcher | ||
Anger om det finns en egenskap angiven för ett objekt. | Object | ||
Called automatically by the MXML compiler when the Validator
is created using an MXML tag. | Validator | ||
Anger om en instans av klassen Object finns i prototypkedjan för objektet som anges som parameter. | Object | ||
Anger om den angivna egenskapen finns och är uppräkningsbar. | Object | ||
Tar bort en avlyssnare från EventDispatcher-objektet. | EventDispatcher | ||
Anger tillgänglighet för en dynamisk egenskap för slingåtgärder. | Object | ||
Returnerar det här objektets strängrepresentation, formaterad i enlighet med språkspecifika konventioner. | Object | ||
Returnerar det angivna objektets strängbeteckning. | Object | ||
Performs validation and optionally notifies
the listeners of the result. | Validator | ||
[statisk]
Invokes all the validators in the validators Array. | Validator | ||
[statisk]
Convenience method for calling a validator
from within a custom validation function. | DateValidator | ||
Returnerar det angivna objektets primitiva värde. | Object | ||
Kontrollerar om en händelseavlyssnare är registrerad för det här EventDispatcher-objektet eller något av dess överordnade objekt för den angivna händelsetypen. | EventDispatcher |
Metod | Definieras med | ||
---|---|---|---|
Sets up all of the listeners for the
valid and invalid
events dispatched from the validator. | Validator | ||
[åsidosätt]
Override of the base class doValidation() method
to validate a date. | DateValidator | ||
Returns the Object to validate. | Validator | ||
Returns a ValidationResultEvent from the Array of error results. | Validator | ||
Returns true if value is not null. | Validator | ||
Disconnects all of the listeners for the
valid and invalid
events dispatched from the validator. | Validator | ||
This method is called when a Validator is constructed,
and again whenever the ResourceManager dispatches
a "change" Event to indicate
that the localized resources have changed in some way. | Validator |
allowedFormatChars | egenskap |
allowedFormatChars:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
The set of formatting characters allowed for separating the month, day, and year values.
Standardvärdet är "/\-. ".
Implementering
public function get allowedFormatChars():String
public function set allowedFormatChars(value:String):void
dayListener | egenskap |
dayListener:IValidatorListener
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
The component that listens for the validation result
for the day subfield.
If none is specified, use the value specified
for the daySource
property.
Implementering
public function get dayListener():IValidatorListener
public function set dayListener(value:IValidatorListener):void
dayProperty | egenskap |
public var dayProperty:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Name of the day property to validate.
This property is optional, but if you specify the
daySource
property, you should also set this property.
daySource | egenskap |
daySource:Object
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Object that contains the value of the day field.
If you specify a value for this property, you must also
specify a value for the dayProperty
property.
Do not use this property if you set the source
and property
properties.
Implementering
public function get daySource():Object
public function set daySource(value:Object):void
formatError | egenskap |
formatError:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Error message when the inputFormat
property
is not in the correct format.
Standardvärdet är "Configuration error: Incorrect formatting string.".
Implementering
public function get formatError():String
public function set formatError(value:String):void
inputFormat | egenskap |
inputFormat:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
The date format to validate the value against. "MM" is the month, "DD" is the day, and "YYYY" is the year. This String is case-sensitive.
Standardvärdet är "MM/DD/YYYY".
Implementering
public function get inputFormat():String
public function set inputFormat(value:String):void
invalidCharError | egenskap |
invalidCharError:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Error message when there are invalid characters in the date.
Standardvärdet är "Invalid characters in your date.".
Implementering
public function get invalidCharError():String
public function set invalidCharError(value:String):void
monthListener | egenskap |
monthListener:IValidatorListener
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
The component that listens for the validation result
for the month subfield.
If none is specified, use the value specified
for the monthSource
property.
Implementering
public function get monthListener():IValidatorListener
public function set monthListener(value:IValidatorListener):void
monthProperty | egenskap |
public var monthProperty:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Name of the month property to validate.
This property is optional, but if you specify the
monthSource
property, you should also set this property.
monthSource | egenskap |
monthSource:Object
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Object that contains the value of the month field.
If you specify a value for this property, you must also specify
a value for the monthProperty
property.
Do not use this property if you set the source
and property
properties.
Implementering
public function get monthSource():Object
public function set monthSource(value:Object):void
validateAsString | egenskap |
validateAsString:Object
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Determines how to validate the value.
If set to true
, the validator evaluates the value
as a String, unless the value has a month
,
day
, or year
property.
If false
, the validator evaluates the value
as a Date object.
Standardvärdet är true.
Implementering
public function get validateAsString():Object
public function set validateAsString(value:Object):void
wrongDayError | egenskap |
wrongDayError:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Error message when the day is invalid.
Standardvärdet är "Enter a valid day for the month.".
Implementering
public function get wrongDayError():String
public function set wrongDayError(value:String):void
wrongLengthError | egenskap |
wrongLengthError:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Error message when the length of the date
doesn't match that of the inputFormat
property.
Standardvärdet är "Type the date in the format inputFormat.".
Implementering
public function get wrongLengthError():String
public function set wrongLengthError(value:String):void
wrongMonthError | egenskap |
wrongMonthError:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Error message when the month is invalid.
Standardvärdet är "Enter a month between 1 and 12.".
Implementering
public function get wrongMonthError():String
public function set wrongMonthError(value:String):void
wrongYearError | egenskap |
wrongYearError:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Error message when the year is invalid.
Standardvärdet är "Enter a year between 0 and 9999.".
Implementering
public function get wrongYearError():String
public function set wrongYearError(value:String):void
yearListener | egenskap |
yearListener:IValidatorListener
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
The component that listens for the validation result
for the year subfield.
If none is specified, use the value specified
for the yearSource
property.
Implementering
public function get yearListener():IValidatorListener
public function set yearListener(value:IValidatorListener):void
yearProperty | egenskap |
public var yearProperty:String
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Name of the year property to validate.
This property is optional, but if you specify the
yearSource
property, you should also set this property.
yearSource | egenskap |
yearSource:Object
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Object that contains the value of the year field.
If you specify a value for this property, you must also specify
a value for the yearProperty
property.
Do not use this property if you set the source
and property
properties.
Implementering
public function get yearSource():Object
public function set yearSource(value:Object):void
DateValidator | () | Konstruktor |
public function DateValidator()
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Constructor.
doValidation | () | metod |
override protected function doValidation(value:Object):Array
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Override of the base class doValidation()
method
to validate a date.
You do not call this method directly; Flex calls it as part of performing a validation. If you create a custom validator class, you must implement this method.
Parametrar
value:Object — Either a String or an Object to validate.
|
Array — An Array of ValidationResult objects, with one ValidationResult
object for each field examined by the validator.
|
validateDate | () | metod |
public static function validateDate(validator:DateValidator, value:Object, baseField:String):Array
Språkversion: | ActionScript 3.0 |
Produktversion: | Flex 3 |
Körningsmiljöversioner: | Flash Player 9, AIR 1.1 |
Convenience method for calling a validator from within a custom validation function. Each of the standard Flex validators has a similar convenience method.
Parametrar
validator:DateValidator — The DateValidator instance.
| |
value:Object — A field to validate.
| |
baseField:String — Text representation of the subfield
specified in the value parameter.
For example, if the value parameter
specifies value.date, the baseField value is "date".
|
Array — An Array of ValidationResult objects, with one ValidationResult
object for each field examined by the validator.
|
Relaterade API-element
<?xml version="1.0" encoding="utf-8"?> <!-- Simple example to demonstrate the DateValidator. --> <s:Application xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx"> <fx:Script> import mx.controls.Alert; </fx:Script> <fx:Declarations> <fx:Model id="CheckModel"> <dateInfo> <DOB>{dob.text}</DOB> </dateInfo> </fx:Model> <mx:DateValidator source="{dob}" property="text" allowedFormatChars="/" trigger="{myButton}" triggerEvent="click" valid="Alert.show('Validation Succeeded!');"/> </fx:Declarations> <s:Panel title="DateValidator Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <mx:Form left="10" right="10" top="10" bottom="10"> <mx:FormItem label="Enter date of birth (mm/dd/yyyy): "> <s:TextInput id="dob" width="100%"/> </mx:FormItem> <mx:FormItem > <s:Button id="myButton" label="Validate" /> </mx:FormItem> </mx:Form> </s:Panel> </s:Application>
Tue Jun 12 2018, 01:40 PM Z