CurrencyValidator

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

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

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

mx.validators.CurrencyValidatorAlignSymbol

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

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

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

	Свойство		Определено
		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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

mx.validators.CurrencyValidatorAlignSymbol

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

currencySymbol

свойство

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

currencySymbolError

свойство

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

decimalPointCountError

свойство

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

decimalSeparator

свойство

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

exceedsMaxError

свойство

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):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 равноценна установке для NumberValidator.domain значения int. Установка на -1 означает игнорирование.

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

Реализация
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

Символ, используемый для разделения тысяч. Не может быть числом и должен отличаться от currencySymbol и decimalSeparator.

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

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

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

()

Конструктор

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

mx.validators.ValidationResult

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

CurrencyValidatorExample.mxml

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

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

CurrencyValidator - AS3 Flex

Классы x

alignSymbol

allowNegative

currencySymbol

currencySymbolError

decimalPointCountError

decimalSeparator

exceedsMaxError

invalidCharError

invalidFormatCharsError

lowerThanMinError

maxValue

minValue

negativeError

precision

precisionError

separationError

thousandsSeparator