NumberValidator

Пакет	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 expanded

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

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

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

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

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

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

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

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

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

	Метод		Определено
		NumberValidator() Конструктор.	NumberValidator
		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
		validateNumber(validator:NumberValidator, value:Object, baseField:String):Array [статические] Удобный метод для вызова средства проверки в пользовательской функции проверки.	NumberValidator
		valueOf():Object Возвращает элементарное значение заданного объекта.	Object
		willTrigger(type:String):Boolean Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником.	EventDispatcher

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

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

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

	Метод		Определено
		addListenerHandler():void Настраивает все прослушиватели на события valid и invalid, передаваемые из средства проверки.	Validator
		doValidation(value:Object):Array [переопределить] Переопределение метода базового класса doValidation() для проверки числа.	NumberValidator
		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

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

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

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

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

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

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):void

decimalPointCountError

свойство

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):void

decimalSeparator

свойство

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):void

domain

свойство

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):void

exceedsMaxError

свойство

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):void

integerError

свойство

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):void

invalidCharError

свойство

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):void

invalidFormatCharsError

свойство

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):void

lowerThanMinError

свойство

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):void

maxValue

свойство

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):void

minValue

свойство

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):void

negativeError

свойство

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):void

precision

свойство

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):void

precisionError

свойство

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):void

separationError

свойство

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):void

thousandsSeparator

свойство

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):void

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

()

Конструктор

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

mx.validators.ValidationResult

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

NumberValidatorExample.mxml

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

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

NumberValidator - AS3 Flex

Пакетыx

Элементы языка

Приложения

Пакет mx.validators

allowNegative

decimalPointCountError

decimalSeparator

domain

exceedsMaxError

integerError

invalidCharError

invalidFormatCharsError

lowerThanMinError

maxValue

minValue

negativeError

precision

precisionError

separationError

thousandsSeparator