| Пакет | mx.validators |
| Класс | public class NumberValidator |
| Наследование | NumberValidator  Validator EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
 | Начиная с Flex 4.5, Adobe рекомендует вместо этого класса использовать класс spark.validators.NumberValidator. |
Класс NumberValidator обеспечивает допустимое значение в строке. Он может обеспечивать попадание вводимого значения в пределы заданного диапазона (определяется
minValue и maxValue), значение в виде целого числа (определяется domain), неотрицательное значение (определяется allowNegative) и не превышение указанного параметра precision. Средство проверки проверяет отформатированные числа (например, 12,345.67), а в целях интернационализации можно задать свойства thousandsSeparator и decimalSeparator.
Синтаксис MXML
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <mx:NumberValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<mx:NumberValidator
allowNegative="true|false"
decimalPointCountError="The decimal separator can only occur once."
decimalSeparator="."
domain="real|int"
exceedsMaxError="The number entered is too large."
integerError="The number must be an integer."
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="-1"
precisionError="The amount entered has too many digits beyond the decimal point."
separationError="The thousands separator must be followed by three digits."
thousandsSeparator=","
/>
| Свойство | Определено | ||
|---|---|---|---|
| allowNegative : Object
Указывает возможность использования отрицательных чисел. | NumberValidator | ||
 | constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| decimalPointCountError : String
Сообщение об ошибке при обнаружении нескольких десятичных разделителей. | NumberValidator | ||
| decimalSeparator : String
Символ, используемый для отделения целой части числа от дробной. | NumberValidator | ||
| domain : String
Тип проверяемого числа. | NumberValidator | ||
| enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | Validator | |
| exceedsMaxError : String
Сообщение об ошибке, если значение превышает свойство maxValue. | NumberValidator | ||
| integerError : String
Сообщение об ошибке, если необходимо ввести целое число, как определено свойством domain. | NumberValidator | ||
| invalidCharError : String
Сообщение об ошибке при обнаружении в значении недопустимых символов. | NumberValidator | ||
| invalidFormatCharsError : String
Сообщение об ошибке при обнаружении в значении символов недопустимого формата, т. е. числа или знака «минус» (-) в качестве символа-разделителя или двух или более последовательных символов-разделителей. | NumberValidator | ||
| listener : Object
Указывает прослушиватель проверки. | Validator | |
| lowerThanMinError : String
Сообщение об ошибке, если значение меньше, чем minValue. | NumberValidator | ||
| maxValue : Object
Максимальное значение допустимого числа. | NumberValidator | ||
| minValue : Object
Минимальное значение допустимого числа. | NumberValidator | ||
| negativeError : String
Сообщение об ошибке, если значение отрицательное и свойство allowNegative имеет значение false. | NumberValidator | ||
| precision : Object
Максимальное количество цифр после запятой. | NumberValidator | ||
| precisionError : String
Сообщение об ошибке, если точность значения превышает значение, определенное свойством precision. | NumberValidator | ||
| property : String
Строка с именем свойства для объекта source, содержащего проверяемое значение. | Validator | |
| required : Boolean = true
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением. | Validator | |
| requiredFieldError : String
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true. | Validator | |
| separationError : String
Сообщение об ошибке при обнаружении тысячного разделителя в неправильном местоположении. | NumberValidator | ||
| source : Object
Указывает объект, содержащий проверяемое свойство. | Validator | |
| thousandsSeparator : String
Символ, используемый для разделения тысяч в целой части числа. | NumberValidator | ||
| trigger : IEventDispatcher
Указывает компонент, генерирующий запускающее средство проверки событие. | Validator | |
| triggerEvent : String
Указывает запускающее проверку событие. | Validator | |
| Метод | Определено | ||
|---|---|---|---|
Конструктор. | NumberValidator | ||
| 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 | |
[статические]
Удобный метод для вызова средства проверки в пользовательской функции проверки. | NumberValidator | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
| Метод | Определено | ||
|---|---|---|---|
|
Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки. | Validator | |
[переопределить]
Переопределение метода базового класса doValidation() для проверки числа. | NumberValidator | ||
|
Возвращает проверяемый объект. | Validator | |
|
Возвращает ValidationResultEvent из массива результатов ошибки. | Validator | |
|
Возвращает true, если value не имеет значения null. | Validator | |
|
Отключает все прослушиватели для событий valid и invalid, передаваемых из средства проверки. | Validator | |
|
Этот метод вызывается при создании класса Validator и каждый раз при отправке ResourceManager события change для указания изменения локализованных ресурсов сходным образом. | Validator | |
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):voiddecimalPointCountError | свойство |
decimalPointCountError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке при обнаружении нескольких десятичных разделителей.
Значением по умолчанию является "The decimal separator can occur only 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 |
Символ, используемый для отделения целой части числа от дробной. Не может быть цифрой и должен отличаться от thousandsSeparator.
Значением по умолчанию является ".".
Реализация
public function get decimalSeparator():String public function set decimalSeparator(value:String):voiddomain | свойство |
domain:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Тип проверяемого числа. К допустимым значениям относятся real и int.
В ActionScript для установки значения этого свойства можно использовать следующие константы: NumberValidatorDomainType.REAL или NumberValidatorDomainType.INT.
Значением по умолчанию является "real".
Реализация
public function get domain():String public function set domain(value:String):voidexceedsMaxError | свойство |
exceedsMaxError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке, если значение превышает свойство maxValue.
Значением по умолчанию является "The number entered is too large.".
Реализация
public function get exceedsMaxError():String public function set exceedsMaxError(value:String):voidintegerError | свойство |
integerError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Сообщение об ошибке, если необходимо ввести целое число, как определено свойством domain.
Значением по умолчанию является "The number must be an integer.".
Реализация
public function get integerError():String public function set integerError(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 равноценно определению для domain значения int. Значение -1 означает игнорирование.
Значением по умолчанию является -1.
Реализация
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 |
Символ, используемый для разделения тысяч в целой части числа. Не может быть цифрой и должен отличаться от decimalSeparator.
Значением по умолчанию является ",".
Реализация
public function get thousandsSeparator():String public function set thousandsSeparator(value:String):voidNumberValidator | () | Конструктор |
public function NumberValidator()| Язык версии: | 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 для каждого поля, проверенного средством проверки.
|
validateNumber | () | метод |
public static function validateNumber(validator:NumberValidator, value:Object, baseField:String):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 3 |
| Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удобный метод для вызова средства проверки в пользовательской функции проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод.
Параметры
validator:NumberValidator — Экземпляр NumberValidator.
| |
value:Object — Проверяемое поле.
| |
baseField:String — Текстовое представление подчиненного поля определяется в параметре value. Например, если параметр value имеет значение value.number, то baseField имеет значение number.
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
Связанные элементы API
<?xml version="1.0" encoding="utf-8"?>
<!-- Simple example to demonstrate the NumberValidator. -->
<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:NumberValidator source="{age}" property="text" integerError="Enter Integer value"
minValue="18" maxValue="50" domain="int"
trigger="{myButton}" triggerEvent="click"
valid="Alert.show('Validation Succeeded!');"
invalid="Alert.show('Validation failed!');"/>
</fx:Declarations>
<s:Panel title="NumberValidator Example"
width="75%" height="75%"
horizontalCenter="0" verticalCenter="0">
<mx:Form left="10" right="10" top="10" bottom="10">
<mx:FormItem label="Enter an age between 18 and 50:">
<s:TextInput id="age" 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