| Пакет | mx.validators |
| Класс | public class CurrencyValidator |
| Наследование | CurrencyValidator  Validator EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
 | Начиная с Flex 4.5, Adobe рекомендует вместо этого класса использовать класс spark.validators.CurrencyValidator. |
Класс CurrencyValidator обеспечивает представление в строке допустимого выражения валюты. Он проверяет вводимые данные на попадание в пределы указанного диапазона (определяется значениями
minValue и maxValue), на неотрицательное значение (определяется значениями allowNegative) и на попадание в пределы указанного параметра precision. Класс CurrencyValidator проверяет правильность отформатированных и неотформатированных выражений валюты, например $12,345.00 и 12345. Для интернационализации можно настроить свойства currencySymbol, alignSymbol, thousandsSeparator и decimalSeparator.
Синтаксис MXML
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:CurrencyValidator> tag
inherits all of the tag properties of its superclass,
and adds the following tag properties:
<mx:CurrencyValidator
alignSymbol="left|right|any"
allowNegative="true|false"
currencySymbol="$"
currencySymbolError="The currency symbol occurs in an invalid location."
decimalPointCountError="The decimal separator can occur only once."
decimalSeparator="."
exceedsMaxError="The amount entered is too large."
invalidCharError="The input contains invalid characters."
invalidFormatCharsError="One of the formatting parameters is invalid."
lowerThanMinError="The amount entered is too small."
maxValue="NaN"
minValue="NaN"
negativeError="The amount may not be negative."
precision="2"
precisionError="The amount entered has too many digits beyond the decimal point."
separationError="The thousands separator must be followed by three digits."
thousandsSeparator=","
/>
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
| alignSymbol : String
Определяет выравнивание currencySymbol относительно остальной части выражения. | CurrencyValidator | ||
| allowNegative : Object
Указывает возможность использования отрицательных чисел. | CurrencyValidator | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| currencySymbol : String
Строка символов, используемая для определения символа валюты, например $, R$ или #163;. | CurrencyValidator | ||
| currencySymbolError : String
Сообщение об ошибке при обнаружении символа валюты, определенного currencySymbol, в неправильном местоположении. | CurrencyValidator | ||
| decimalPointCountError : String
Сообщение об ошибке при обнаружении нескольких десятичных разделителей. | CurrencyValidator | ||
| decimalSeparator : String
Символ, используемый для отделения целой части числа от дробной. | CurrencyValidator | ||
| enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | Validator | |
| exceedsMaxError : String
Сообщение об ошибке, если значение больше, чем maxValue. | CurrencyValidator | ||
| invalidCharError : String
Сообщение об ошибке при обнаружении недопустимых символов в валюте. | CurrencyValidator | ||
| invalidFormatCharsError : String
Сообщение об ошибке при обнаружении в значении недопустимого символа форматирования. | CurrencyValidator | ||
| listener : Object
Указывает прослушиватель проверки. | Validator | |
| lowerThanMinError : String
Сообщение об ошибке, если значение меньше, чем minValue. | CurrencyValidator | ||
| maxValue : Object
Максимальное значение допустимого числа. | CurrencyValidator | ||
| minValue : Object
Минимальное значение допустимого числа. | CurrencyValidator | ||
| negativeError : String
Сообщение об ошибке, если значение отрицательное и свойство allowNegative имеет значение false. | CurrencyValidator | ||
| precision : Object
Максимальное количество цифр после запятой. | CurrencyValidator | ||
| precisionError : String
Сообщение об ошибке, если точность значения превышает значение, определенное свойством precision. | CurrencyValidator | ||
| property : String
Строка с именем свойства для объекта source, содержащего проверяемое значение. | Validator | |
| required : Boolean = true
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением. | Validator | |
| requiredFieldError : String
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true. | Validator | |
| separationError : String
Сообщение об ошибке при обнаружении неправильного местоположения тысячного разделителя. | CurrencyValidator | ||
| source : Object
Указывает объект, содержащий проверяемое свойство. | Validator | |
| thousandsSeparator : String
Символ, используемый для разделения тысяч. | CurrencyValidator | ||
| trigger : IEventDispatcher
Указывает компонент, генерирующий запускающее средство проверки событие. | Validator | |
| triggerEvent : String
Указывает запускающее проверку событие. | Validator | |
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | CurrencyValidator | ||
| 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 | |
[статические]
Удобный метод для выполнения вызова средства проверки. | CurrencyValidator | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
|
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки. | Validator | |
[переопределить]
Переопределяет метод базового класса doValidation() для проверки выражения валюты. | CurrencyValidator | ||
|
Возвращает проверяемый объект. | Validator | |
|
Возвращает ValidationResultEvent из массива результатов ошибки. | Validator | |
|
Возвращает true, если value не имеет значения null. | Validator | |
|
Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки. | Validator | |
|
Этот метод вызывается при создании класса Validator и каждый раз при отправке ResourceManager события change для указания изменения локализованных ресурсов сходным образом. | Validator | |
alignSymbol | свойство |
alignSymbol:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Определяет выравниваниеcurrencySymbol относительно остальной части выражения. Допустимыми значениями в ActionScript являютсяCurrencyValidatorAlignSymbol.LEFT, CurrencyValidatorAlignSymbol.RIGHT и CurrencyValidatorAlignSymbol.ANY. Допустимыми значениями в MXML являются left, right и any.
Значением по умолчанию является CurrencyValidatorAlignSymbol.LEFT.
Реализация
public function get alignSymbol():String public function set alignSymbol(value:String):voidСвязанные элементы API
allowNegative | свойство |
allowNegative:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает возможность использования отрицательных чисел. Может иметь значение true или false.
Значением по умолчанию является true.
Реализация
public function get allowNegative():Object public function set allowNegative(value:Object):voidcurrencySymbol | свойство |
currencySymbol:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Строка символов, используемая для определения символа валюты, например $, R$ или ?. Не может быть цифрой и должна отличаться от thousandsSeparator и decimalSeparator.
Значением по умолчанию является "$".
Реализация
public function get currencySymbol():String public function set currencySymbol(value:String):voidcurrencySymbolError | свойство |
currencySymbolError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении символа валюты, определенного currencySymbol, в неправильном местоположении.
Значением по умолчанию является "The currency symbol occurs in an invalid location.".
Реализация
public function get currencySymbolError():String public function set currencySymbolError(value:String):voiddecimalPointCountError | свойство |
decimalPointCountError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении нескольких десятичных разделителей.
Значением по умолчанию является "The decimal separator can only occur once.".
Реализация
public function get decimalPointCountError():String public function set decimalPointCountError(value:String):voiddecimalSeparator | свойство |
decimalSeparator:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Символ, используемый для отделения целой части числа от дробной. Не может быть числом и должен отличаться от currencySymbol и thousandsSeparator.
Значением по умолчанию является ".".
Реализация
public function get decimalSeparator():String public function set decimalSeparator(value:String):voidexceedsMaxError | свойство |
exceedsMaxError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке, если значение больше, чем maxValue.
Значением по умолчанию является "The amount entered is too large.".
Реализация
public function get exceedsMaxError():String public function set exceedsMaxError(value:String):voidinvalidCharError | свойство |
invalidCharError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении недопустимых символов в валюте.
Значением по умолчанию является "The input contains invalid characters.".
Реализация
public function get invalidCharError():String public function set invalidCharError(value:String):voidinvalidFormatCharsError | свойство |
invalidFormatCharsError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении в значении недопустимого символа форматирования.
Значением по умолчанию является "One of the formatting parameters is invalid.".
Реализация
public function get invalidFormatCharsError():String public function set invalidFormatCharsError(value:String):voidlowerThanMinError | свойство |
lowerThanMinError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке, если значение меньше, чем minValue.
Значением по умолчанию является "The amount entered is too small.".
Реализация
public function get lowerThanMinError():String public function set lowerThanMinError(value:String):voidmaxValue | свойство |
maxValue:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Максимальное значение допустимого числа. Значение NaN означает игнорирование.
Значением по умолчанию является NaN.
Реализация
public function get maxValue():Object public function set maxValue(value:Object):voidminValue | свойство |
minValue:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Минимальное значение допустимого числа. Значение NaN означает игнорирование.
Значением по умолчанию является NaN.
Реализация
public function get minValue():Object public function set minValue(value:Object):voidnegativeError | свойство |
negativeError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке, если значение отрицательное и свойство allowNegative имеет значение false.
Значением по умолчанию является "The amount may not be negative.".
Реализация
public function get negativeError():String public function set negativeError(value:String):voidprecision | свойство |
precision:Object| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Максимальное количество цифр после запятой. Любое неотрицательное целое число. Примечание. Установка значения 0 равноценна установке для NumberValidator.domain значения int. Установка на -1 означает игнорирование.
Значением по умолчанию является 2.
Реализация
public function get precision():Object public function set precision(value:Object):voidprecisionError | свойство |
precisionError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке, если точность значения превышает значение, определенное свойством precision.
Значением по умолчанию является "The amount entered has too many digits beyond the decimal point.".
Реализация
public function get precisionError():String public function set precisionError(value:String):voidseparationError | свойство |
separationError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении неправильного местоположения тысячного разделителя.
Значением по умолчанию является "The thousands separator must be followed by three digits.".
Реализация
public function get separationError():String public function set separationError(value:String):voidthousandsSeparator | свойство |
thousandsSeparator:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Символ, используемый для разделения тысяч. Не может быть числом и должен отличаться от currencySymbol и decimalSeparator.
Значением по умолчанию является ",".
Реализация
public function get thousandsSeparator():String public function set thousandsSeparator(value:String):voidCurrencyValidator | () | Конструктор |
public function CurrencyValidator()| Язык версии: | 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 для каждого поля, проверенного средством проверки.
|
validateCurrency | () | метод |
public static function validateCurrency(validator:CurrencyValidator, value:Object, baseField:String):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удобный метод для выполнения вызова средства проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод.
Параметры
validator:CurrencyValidator — Экземпляр CurrencyValidator.
| |
value:Object — Проверяемый объект.
| |
baseField:String — Текстовое представление подчиненного поля определяется в параметре value. Например, если параметр value имеет значение value.currency, значением baseField является currency.
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
Связанные элементы API
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the CurrencyValidator. -->
<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:CurrencyValidator source="{priceUS}" property="text" precision="2"
trigger="{myButton}" triggerEvent="click"
valid="Alert.show('Validation Succeeded!');"/>
</fx:Declarations>
<s:Panel title="CurrencyValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter a U.S. dollar amount: ">
<s:TextInput id="priceUS" 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