DateValidator

Пакет	mx.validators
Класс	public class DateValidator
Наследование	DateValidator Validator EventDispatcher Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Класс DateValidator проверяет содержимое соответствующей даты в строке, дате или объекте и соответствие указанному формату. В значение месяца, дня и года пользователи могут вводить одну или две цифры. По умолчанию средство проверки обеспечивает следующие форматы:

месяц: от 1 до 12 (или 0 – 11 для объектов Date);
день: от 1 до 31;
год: число.

Определить дату в классе DateValidator можно двумя способами:

Отдельной строкой с датой – для определения строки используются свойства source и property. Строка может содержать цифры и символы форматирования, определенные свойством allowedFormatChars, например символы "/\-. ". По умолчанию формат ввода даты в поле строки: MM/DD/YYYY, где ММ – месяц, DD – день и YYYY – год. Свойство inputFormat можно использовать для определения другого формата.
Объект Date.
Объект или несколько полей, содержащие день, месяц и год. Все следующие свойства используются для определения значений дня, месяца и года: daySource, dayProperty, monthSource, monthProperty, yearSource и yearProperty.

Синтаксис MXML expanded

Скрыть синтаксис MXML

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"
  />

Посмотреть примеры

Общедоступные свойства

Скрыть унаследованные общедоступные свойства

Показать унаследованные общедоступные свойства

	Свойство		Определено
		allowedFormatChars : String Набор символов форматирования, допустимых для разделения значений месяца, дня и года.	DateValidator
		constructor : Object Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.	Object
		dayListener : IValidatorListener Компонент, прослушивающий результат проверки подчиненного поля дня.	DateValidator
		dayProperty : String Имя проверяемого свойства day.	DateValidator
		daySource : Object Объект, содержащий значение поля дня.	DateValidator
		enabled : Boolean Установка этого значения на false помешает выполнению проверки средством проверки.	Validator
		formatError : String Сообщение об ошибке при обнаружении неверного формата свойства inputFormat.	DateValidator
		inputFormat : String Формат даты для проверки значения.	DateValidator
		invalidCharError : String Сообщение об ошибке при обнаружении в дате недопустимых символов.	DateValidator
		listener : Object Указывает прослушиватель проверки.	Validator
		monthListener : IValidatorListener Компонент, прослушивающий результат проверки подчиненного поля месяца.	DateValidator
		monthProperty : String Имя проверяемого свойства month.	DateValidator
		monthSource : Object Объект, содержащий значение поля месяца.	DateValidator
		property : String Строка с именем свойства для объекта source, содержащего проверяемое значение.	Validator
		required : Boolean = true Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением.	Validator
		requiredFieldError : String Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true.	Validator
		source : Object Указывает объект, содержащий проверяемое свойство.	Validator
		trigger : IEventDispatcher Указывает компонент, генерирующий запускающее средство проверки событие.	Validator
		triggerEvent : String Указывает запускающее проверку событие.	Validator
		validateAsString : Object Определяет способ проверки значения.	DateValidator
		wrongDayError : String Сообщение об ошибке при обнаружении недопустимого значения дня.	DateValidator
		wrongLengthError : String Сообщение об ошибке при несоответствии длины даты длине в свойстве inputFormat.	DateValidator
		wrongMonthError : String Сообщение об ошибке при обнаружении недопустимого значения месяца.	DateValidator
		wrongYearError : String Сообщение об ошибке при обнаружении недопустимого значения года.	DateValidator
		yearListener : IValidatorListener Компонент, прослушивающий результат проверки подчиненного поля года.	DateValidator
		yearProperty : String Имя проверяемого свойства year.	DateValidator
		yearSource : Object Объект, содержащий значение поля года.	DateValidator

Защищенные свойства

Скрыть унаследованные защищенные свойства

Показать унаследованные защищенные свойства

	Свойство		Определено
		actualListeners : Array [только для чтения] Содержит массив объектов прослушивателей при их наличии или исходный объект.	Validator
		actualTrigger : IEventDispatcher [только для чтения] Содержит объект-триггер при его наличии или исходный объект.	Validator
		resourceManager : IResourceManager [только для чтения] Ссылка на объект, управляющий всеми локализованными ресурсами приложения.	Validator
		subFields : Array Массив строк, содержащий имена свойств из объекта value, переданного в метод validate().	Validator

Общедоступные методы

Скрыть унаследованные общедоступные методы

Показать унаследованные общедоступные методы

	Метод		Определено
		DateValidator() Конструктор.	DateValidator
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии.	EventDispatcher
		dispatchEvent(event:Event):Boolean Посылает событие в поток событий.	EventDispatcher
		hasEventListener(type:String):Boolean Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события.	EventDispatcher
		hasOwnProperty(name:String):Boolean Показывает, определено ли заданное свойство для объекта.	Object
		initialized(document:Object, id:String):void Вызывается автоматически компилятором MXML при создании класса Validator с помощью тега MXML.	Validator
		isPrototypeOf(theClass:Object):Boolean Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.	Object
		propertyIsEnumerable(name:String):Boolean Показывает наличие заданного свойства и его перечисляемость.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Удаляет прослушиватель из объекта EventDispatcher.	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Задает доступность динамического свойства для операций цикла.	Object
		toLocaleString():String Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.	Object
		toString():String Возвращает строковое представление заданного объекта.	Object
		validate(value:Object = null, suppressEvents:Boolean = false):ValidationResultEvent Выполняет проверку и дополнительно оповещает прослушиватели результата.	Validator
		validateAll(validators:Array):Array [статические] Вызывает все средства проверки в массиве validators.	Validator
		validateDate(validator:DateValidator, value:Object, baseField:String):Array [статические] Удобный метод для вызова средства проверки в пользовательской функции проверки.	DateValidator
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

Защищенные методы

Скрыть унаследованные защищенные методы

Показать унаследованные защищенные методы

	Метод		Определено
		addListenerHandler():void Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки.	Validator
		doValidation(value:Object):Array [переопределить] Переопределяет метод базового класса doValidation() для проверки даты.	DateValidator
		getValueFromSource():Object Возвращает проверяемый объект.	Validator
		handleResults(errorResults:Array):ValidationResultEvent Возвращает ValidationResultEvent из массива результатов ошибки.	Validator
		isRealValue(value:Object):Boolean Возвращает true, если value не имеет значения null.	Validator
		removeListenerHandler():void Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки.	Validator
		resourcesChanged():void Этот метод вызывается при создании класса Validator и каждый раз при отправке ResourceManager события change для указания изменения локализованных ресурсов сходным образом.	Validator

События

Дополнительные сведения о событиях

Скрыть унаследованные события

Показать унаследованные события

	Сводка	Определено
activate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR перемещается в фокус операционной системы и становится активным.	EventDispatcher
deactivate	[многоадресное событие] Отправляется, когда проигрыватель Flash Player или приложение AIR теряет фокус системы и становится неактивным.	EventDispatcher
invalid	Передается при сбое проверки.	Validator
valid	Передается при успешном завершении проверки.	Validator

Защищенные константы

Скрыть унаследованные защищенные константы

Показать унаследованные защищенные константы

	Константа		Определено

Сведения о свойстве

allowedFormatChars

свойство

allowedFormatChars:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Набор символов форматирования, допустимых для разделения значений месяца, дня и года.

Значением по умолчанию является "/\-. ".

Реализация
public function get allowedFormatChars():String
public function set allowedFormatChars(value:String):void

dayListener

свойство

dayListener:IValidatorListener

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Компонент, прослушивающий результат проверки подчиненного поля дня. Если он не указан, используется значение, указанное для свойства daySource.

Реализация
public function get dayListener():IValidatorListener
public function set dayListener(value:IValidatorListener):void

dayProperty

свойство

public var dayProperty:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Имя проверяемого свойства day. Это свойство является необязательным, но если определено свойство daySource, следует также указать это свойство.

daySource

свойство

daySource:Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Объект, содержащий значение поля дня. Если для этого свойства указано значение, следует также определить значение для свойства dayProperty. Не используйте это свойство, если определены свойства source и property.

Реализация
public function get daySource():Object
public function set daySource(value:Object):void

formatError

свойство

formatError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении неверного формата свойства inputFormat.

Значением по умолчанию является "Configuration error: Incorrect formatting string.".

Реализация
public function get formatError():String
public function set formatError(value:String):void

inputFormat

свойство

inputFormat:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Формат даты для проверки значения. ММ – месяц, DD – день и YYYY – год. Строка с учетом регистра.

Значением по умолчанию является "MM/DD/YYYY".

Реализация
public function get inputFormat():String
public function set inputFormat(value:String):void

invalidCharError

свойство

invalidCharError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении в дате недопустимых символов.

Значением по умолчанию является "Invalid characters in your date.".

Реализация
public function get invalidCharError():String
public function set invalidCharError(value:String):void

monthListener

свойство

monthListener:IValidatorListener

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Компонент, прослушивающий результат проверки подчиненного поля месяца. Если он не указан, используется значение, указанное для свойства monthSource.

Реализация
public function get monthListener():IValidatorListener
public function set monthListener(value:IValidatorListener):void

monthProperty

свойство

public var monthProperty:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Имя проверяемого свойства month. Это свойство является необязательным, но если определено свойство monthSource, следует также указать это свойство.

monthSource

свойство

monthSource:Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Объект, содержащий значение поля месяца. Если для этого свойства указано значение, следует также определить значение для свойства monthProperty. Не используйте это свойство, если определены свойства source и property.

Реализация
public function get monthSource():Object
public function set monthSource(value:Object):void

validateAsString

свойство

validateAsString:Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Определяет способ проверки значения. Если установлено true, средство проверки анализирует значение как строку, если только значение не имеет свойства month, day или year. Если значение равно false, средство проверки анализирует значение как объект Date.

Значением по умолчанию является true.

Реализация
public function get validateAsString():Object
public function set validateAsString(value:Object):void

wrongDayError

свойство

wrongDayError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении недопустимого значения дня.

Значением по умолчанию является "Enter a valid day for the month.".

Реализация
public function get wrongDayError():String
public function set wrongDayError(value:String):void

wrongLengthError

свойство

wrongLengthError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при несоответствии длины даты длине в свойстве inputFormat.

Значением по умолчанию является "Type the date in the format inputFormat.".

Реализация
public function get wrongLengthError():String
public function set wrongLengthError(value:String):void

wrongMonthError

свойство

wrongMonthError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении недопустимого значения месяца.

Значением по умолчанию является "Enter a month between 1 and 12.".

Реализация
public function get wrongMonthError():String
public function set wrongMonthError(value:String):void

wrongYearError

свойство

wrongYearError:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Сообщение об ошибке при обнаружении недопустимого значения года.

Значением по умолчанию является "Enter a year between 0 and 9999.".

Реализация
public function get wrongYearError():String
public function set wrongYearError(value:String):void

yearListener

свойство

yearListener:IValidatorListener

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Компонент, прослушивающий результат проверки подчиненного поля года. Если он не определен, используется значение, указанное для свойства yearSource.

Реализация
public function get yearListener():IValidatorListener
public function set yearListener(value:IValidatorListener):void

yearProperty

свойство

public var yearProperty:String

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Имя проверяемого свойства year. Это свойство является необязательным, но если определено свойство yearSource, следует также указать это свойство.

yearSource

свойство

yearSource:Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Объект, содержащий значение поля года. Если для этого свойства определено значение, следует также указать значение для свойства yearProperty. Не используйте это свойство, если определены свойства source и property.

Реализация
public function get yearSource():Object
public function set yearSource(value:Object):void

Сведения о конструкторе

()

Конструктор

public function DateValidator()

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Конструктор.

Сведения о методе

doValidation

()

метод

override protected function doValidation(value:Object):Array

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Переопределяет метод базового класса doValidation() для проверки даты.

Этот метод не вызывается напрямую; Flex вызывает его как часть выполнения проверки. Этот метод необходимо реализовать при создании пользовательского класса Validator.

Параметры

value:Object — Проверяемая строка или объект.

Возвращает

Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.

validateDate

()

метод

public static function validateDate(validator:DateValidator, value:Object, baseField:String):Array

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

Удобный метод для вызова средства проверки в пользовательской функции проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод.

Параметры

	`validator:DateValidator` — Экземпляр DateValidator.

	`value:Object` — Проверяемое поле.

	`baseField:String` — Текстовое представление подчиненного поля определяется в параметре value. Например, если параметр `value` имеет значение value.date, то `baseField` имеет значение date.

Возвращает

Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.

Связанные элементы API

mx.validators.ValidationResult

Примеры Использование этого примера

DateValidatorExample.mxml

<?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>

Юридическая информация | Политика конфиденциальности онлайн

DateValidator - AS3 Flex

Классы x

allowedFormatChars

dayListener

dayProperty

daySource

formatError

inputFormat

invalidCharError

monthListener

monthProperty

monthSource

validateAsString

wrongDayError

wrongLengthError

wrongMonthError

wrongYearError

yearListener

yearProperty

yearSource

DateValidator

doValidation

validateDate