| Пакет | mx.validators |
| Класс | public class ZipCodeValidator |
| Наследование | ZipCodeValidator  Validator EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:ZipCodeValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:ZipCodeValidator
allowedFormatChars=" -"
domain="US Only | US or Canada | Canada Only"
invalidCharError="The ZIP code contains invalid characters."
invalidDomainError="The domain parameter is invalid. It must be either 'US Only', 'Canada Only', or 'US or Canada'."
wrongCAFormatError="The Canadian postal code must be formatted 'A1B 2C3'."
wrongLengthError="The ZIP code must be 5 digits or 5+4 digits."
wrongUSFormatError="The ZIP+4 code must be formatted '12345-6789'."
/>
Связанные элементы API
Общедоступные свойства
| Свойство | Определено | ||
|---|---|---|---|
| allowedFormatChars : String
Набор символов форматирования, допустимых в почтовом индексе. | ZipCodeValidator | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| domain : String
Тип проверяемого почтового индекса. | ZipCodeValidator | ||
| enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | Validator | |
| invalidCharError : String
Сообщение об ошибке при обнаружении недопустимых символов в почтовом индексе. | ZipCodeValidator | ||
| invalidDomainError : String
Сообщение об ошибке при обнаружении недопустимого значения свойства domain. | ZipCodeValidator | ||
| listener : Object
Указывает прослушиватель проверки. | Validator | |
| property : String
Строка с именем свойства для объекта source, содержащего проверяемое значение. | Validator | |
| required : Boolean = true
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением. | Validator | |
| requiredFieldError : String
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true. | Validator | |
| source : Object
Указывает объект, содержащий проверяемое свойство. | Validator | |
| trigger : IEventDispatcher
Указывает компонент, генерирующий запускающее средство проверки событие. | Validator | |
| triggerEvent : String
Указывает запускающее проверку событие. | Validator | |
| wrongCAFormatError : String
Сообщение об ошибке при обнаружении недопустимого значения почтового индекса Канады. | ZipCodeValidator | ||
| wrongLengthError : String
Сообщение об ошибке при обнаружении недопустимого значения почтового индекса США. | ZipCodeValidator | ||
| wrongUSFormatError : String
Сообщение об ошибке в случае некорректно отформатированного почтового индекса. | ZipCodeValidator | ||
Защищенные свойства
Общедоступные методы
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | ZipCodeValidator | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Посылает событие в поток событий. | EventDispatcher | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Вызывается автоматически компилятором MXML при создании класса Validator с помощью тега MXML. | Validator | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Выполняет проверку и дополнительно оповещает прослушиватели результата. | Validator | |
| [статические]
Вызывает все средства проверки в массиве validators. | Validator | |
[статические]
Удобный метод для выполнения вызова средства проверки. | ZipCodeValidator | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
Защищенные методы
| Метод | Определено | ||
|---|---|---|---|
|
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки. | Validator | |
[переопределить]
Переопределяет метод базового класса doValidation() для проверки почтового индекса. | ZipCodeValidator | ||
|
Возвращает проверяемый объект. | Validator | |
|
Возвращает ValidationResultEvent из массива результатов ошибки. | Validator | |
|
Возвращает true, если value не имеет значения null. | Validator | |
|
Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки. | Validator | |
|
Этот метод вызывается при создании класса Validator и каждый раз при отправке ResourceManager события change для указания изменения локализованных ресурсов сходным образом. | Validator | |
События
Защищенные константы
Сведения о свойстве
allowedFormatChars | свойство |
allowedFormatChars:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Набор символов форматирования, допустимых в почтовом индексе. Он не может содержать цифры или буквы [a-z A-Z].
Значением по умолчанию является " -"..
Реализация
public function get allowedFormatChars():String public function set allowedFormatChars(value:String):voiddomain | свойство |
domain:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Тип проверяемого почтового индекса. В MXML допустимыми значениями являются US or Canada, US Only и Canada Only.
В ActionScript можно использовать следующие константы для определения этого свойства: ZipCodeValidatorDomainType.US_ONLY, ZipCodeValidatorDomainType.US_OR_CANADA или ZipCodeValidatorDomainType.CANADA_ONLY.
Значением по умолчанию является ZipCodeValidatorDomainType.US_ONLY.
Реализация
public function get domain():String public function set domain(value:String):voidinvalidCharError | свойство |
invalidCharError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимых символов в почтовом индексе.
Значением по умолчанию является "The ZIP code contains invalid characters.".
Реализация
public function get invalidCharError():String public function set invalidCharError(value:String):voidinvalidDomainError | свойство |
invalidDomainError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимого значения свойства domain.
Значением по умолчанию является "The domain parameter is invalid. It must be either 'US Only' or 'US or Canada'.".
Реализация
public function get invalidDomainError():String public function set invalidDomainError(value:String):voidwrongCAFormatError | свойство |
wrongCAFormatError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимого значения почтового индекса Канады.
Значением по умолчанию является "The Canadian postal code must be formatted 'A1B 2C3'.".
Реализация
public function get wrongCAFormatError():String public function set wrongCAFormatError(value:String):voidwrongLengthError | свойство |
wrongLengthError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимого значения почтового индекса США.
Значением по умолчанию является "The ZIP code must be 5 digits or 5+4 digits.".
Реализация
public function get wrongLengthError():String public function set wrongLengthError(value:String):voidwrongUSFormatError | свойство |
wrongUSFormatError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке в случае некорректно отформатированного почтового индекса.
Значением по умолчанию является "The ZIP+4 code must be formatted '12345-6789'.".
Реализация
public function get wrongUSFormatError():String public function set wrongUSFormatError(value:String):voidСведения о конструкторе
ZipCodeValidator | () | Конструктор |
public function ZipCodeValidator()| Язык версии: | 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 для каждого поля, проверенного средством проверки.
|
validateZipCode | () | метод |
public static function validateZipCode(validator:ZipCodeValidator, value:Object, baseField:String):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удобный метод для выполнения вызова средства проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод.
Параметры
validator:ZipCodeValidator — Экземпляр ZipCodeValidator.
| |
value:Object — Проверяемое поле.
| |
baseField:String — Текстовое представление подчиненного поля определяется в параметре value. Например, если параметр value определен как value.zipCode, то baseField имеет значение zipCode.
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
Связанные элементы API
Примеры Использование этого примера
ZipCodeValidatorExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the ZipCodeValidator. -->
<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>
<mx:ZipCodeValidator source="{zip}" property="text"
trigger="{myButton}" triggerEvent="click"
valid="Alert.show('Validation Succeeded!');"
invalid="Alert.show('Validation Failed!');"/>
</fx:Declarations>
<s:Panel title="ZipcodeValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter a 5 or 9 digit U.S. Zip code: ">
<s:TextInput id="zip" width="100%"/>
</mx:FormItem>
<mx:FormItem >
<s:Button id="myButton" label="Validate" />
</mx:FormItem>
</mx:Form>
</s:Panel>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z