| Пакет | spark.validators |
| Класс | public class CurrencyValidator |
| Наследование | CurrencyValidator  NumberValidatorBase GlobalizationValidatorBase GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
CurrencyValidator обеспечивает представление элементом String действительной суммы денежных средств в соответствии с условиями локали. Этот класс использует стиль locale для указания Locale ID.
Средство проверки гарантирует, что строка денежной суммы соответствует указанному диапазону (определяется свойствами minValue и maxValue), является целым числом (определяется свойством domain), является неотрицательным числом (определяется свойством allowNegative), правильно указывает отрицательные и положительные числа, содержит правильный код ISO или символ валюты и не превышает указанное значение fractionalDigits. Поскольку средство проверки устанавливает стандартные значения свойств с помощью класса flash.globalization.CurrencyFormatter, значения на основе локалей предоставляет операционная система.
Класс flash.globalization.CurrencyFormatter использует базовую операционную систему для предоставления данных на основе локалей. Если операционная система не поддерживает форматирование денежных сумм, этот класс предоставляет резервные функциональные возможности.
Показать синтаксис MXML
Скрыть синтаксис MXMLThe <s:CurrencyValidator> tag
inherits all of the tag attributes of its superclass,
and adds the following tag attributes:
<s:CurrencyValidator
Properties
currencyISOCode="locale specified string or customized by user."
currencyStringError="Currency name is repeated or not correct."
currencySymbol="locale specified string or customized by user."
negativeCurrencyFormat="locale specified string or customized by user."
negativeCurrencyFormatError="The negative format of the input currency is incorrect."
positiveCurrencyFormat="locale specified string or customized by user."
positiveCurrencyFormatError="The positive format of the input currency is incorrect."
/>
Связанные элементы API
| Свойство | Определено | ||
|---|---|---|---|
 | actualLocaleIDName : String [только для чтения]
Имя фактического идентификатора локали, используемое этим объектом класса. | GlobalizationBase | |
| allowNegative : Boolean
Указывает возможность использования отрицательных чисел. | NumberValidatorBase | |
| className : String [только для чтения]
Имя класса компонента. | AdvancedStyleClient | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| currencyISOCode : String
Трехбуквенный код валюты ISO 4217 для используемой локали. | CurrencyValidator | ||
| currencyStringError : String
Сообщение об ошибке, если символ валюты или код ISO валюты повторяются или находятся в недопустимом местоположении. | CurrencyValidator | ||
| currencySymbol : String
Символ или строка валюты для используемой локали. | CurrencyValidator | ||
| decimalPointCountError : String
Сообщение об ошибке при обнаружении нескольких десятичных разделителей. | NumberValidatorBase | |
| decimalSeparator : String
Символ десятичного разделителя используется для проверки чисел, имеющих знаки после запятой. | NumberValidatorBase | |
| digitsType : uint
Определяет набор цифровых символов, которые должны использоваться при проверке чисел. | NumberValidatorBase | |
| domain : String
Тип проверяемого числа. | NumberValidatorBase | |
| enabled : Boolean
Установка этого значения на false помешает выполнению проверки средством проверки. | GlobalizationValidatorBase | |
| fractionalDigits : int
Максимальное число цифр, которые могут отображаться после десятичного разделителя. | NumberValidatorBase | |
| fractionalDigitsError : String
Сообщение об ошибке, когда цифры дроби превышают значение, указанное в свойстве fractionalDigits. | NumberValidatorBase | |
| greaterThanMaxError : String
Сообщение об ошибке, если значение превышает свойство maxValue. | NumberValidatorBase | |
| groupingSeparator : String
Символ или строка, используемые в качестве разделителя группировки. | NumberValidatorBase | |
| id : String
Идентификатор компонента. | AdvancedStyleClient | |
| inheritingStyles : Object
Объект, содержащий стили наследования для экземпляра клиента с невизуальным стилем. | AdvancedStyleClient | |
| invalidCharError : String
Сообщение об ошибке при обнаружении в значении недопустимых символов. | NumberValidatorBase | |
| invalidFormatCharsError : String
Сообщение об ошибке при обнаружении в значении символов недопустимого формата, т. е. числа или знака «минус» (-) в качестве символа-разделителя или двух или более последовательных символов-разделителей. | NumberValidatorBase | |
| lastOperationStatus : String [переопределить] [только для чтения]
Состояние самой последней операции, выполненной этим объектом класса. | NumberValidatorBase | |
| lessThanMinError : String
Сообщение об ошибке, если значение меньше, чем minValue. | NumberValidatorBase | |
| listener : Object
Указывает прослушиватель проверки. | GlobalizationValidatorBase | |
| localeUndefinedError : String
Сообщение об ошибке при неопределенной или недоступной локали. | NumberValidatorBase | |
| maxValue : Number
Максимальное значение допустимого числа. | NumberValidatorBase | |
| minValue : Number
Минимальное значение допустимого числа. | NumberValidatorBase | |
| moduleFactory : IFlexModuleFactory
Фабрика модуля, используемая в качестве контекста для поиска менеджера стилей, управляющего стилями в этом экземпляре клиента с невизуальным стилем. | AdvancedStyleClient | |
| negativeCurrencyFormat : uint
Числовое значение, которое представляет образец проверки для отрицательных денежных сумм. | CurrencyValidator | ||
| negativeCurrencyFormatError : String
Сообщение об ошибке, когда формат отрицательного числа в строке вводимой валюты является недействительным. | CurrencyValidator | ||
| negativeError : String
Сообщение об ошибке, если значение отрицательное и свойство allowNegative имеет значение false. | NumberValidatorBase | |
| negativeSymbol : String [только для чтения]
Отрицательный символ для использования при проверке отрицательных значений. | NumberValidatorBase | |
| negativeSymbolError : String
Сообщение об ошибке, если отрицательный символ повторяется или находится в недопустимом местоположении. | NumberValidatorBase | |
| nonInheritingStyles : Object
Начало цепочки этого компонента с ненаследуемыми стилями. | AdvancedStyleClient | |
| notAnIntegerError : String
Сообщение об ошибке, если необходимо ввести целое число, как определено свойством domain. | NumberValidatorBase | |
| parseError : String
Сообщение об ошибке, когда не удается проанализировать число. | NumberValidatorBase | |
| positiveCurrencyFormat : uint
Числовое значение, которое представляет образец проверки для положительных денежных сумм. | CurrencyValidator | ||
| positiveCurrencyFormatError : String
Сообщение об ошибке, когда формат положительного числа валюты является недействительным. | CurrencyValidator | ||
| property : String
Строка с именем свойства для объекта source, содержащего проверяемое значение. | GlobalizationValidatorBase | |
| required : Boolean = true
Значение true указывает на то, что ошибка проверки вызвана отсутствующим или пустым значением. | GlobalizationValidatorBase | |
| requiredFieldError : String
Сообщение об ошибке, если значение отсутствует, а свойство required имеет значение true. | GlobalizationValidatorBase | |
| source : Object
Указывает объект, содержащий проверяемое свойство. | GlobalizationValidatorBase | |
| styleDeclaration : CSSStyleDeclaration
Объявление стиля, которое содержит действующие стили, объявленные этим объектом. | AdvancedStyleClient | |
| styleManager : IStyleManager2 [только для чтения]
Возвращает экземпляр StyleManager, используемый этим компонентом. | AdvancedStyleClient | |
| styleName : Object
Источник значений стиля данного объекта. | AdvancedStyleClient | |
| styleParent : IAdvancedStyleClient
Вышестоящий узел компонента используется для анализа нижестоящих селекторов. | AdvancedStyleClient | |
| trigger : IEventDispatcher
Указывает компонент, генерирующий запускающее средство проверки событие. | GlobalizationValidatorBase | |
| triggerEvent : String
Указывает запускающее проверку событие. | GlobalizationValidatorBase | |
| Метод | Определено | ||
|---|---|---|---|
Создает новый объект CurrencyValidator для проверки чисел, представляющих денежные суммы в соответствии с правилами данной локали. | CurrencyValidator | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | EventDispatcher | |
|
Удаляет свойство style для экземпляра компонента. | AdvancedStyleClient | |
|
Посылает событие в поток событий. | EventDispatcher | |
|
Возвращает массив объектов CSSStyleDeclaration для селектора типа, применяемого к этому компоненту, или null, если массив не существует. | AdvancedStyleClient | |
| [переопределить]
Получает свойство style, которое было установлено в любом месте в пределах цепочки поиска стиля этого компонента. | GlobalizationBase | |
|
Возвращает true, если для currentCSSState не указано значение null. | AdvancedStyleClient | |
|
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | EventDispatcher | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Инициализированный метод вызывается, когда этот класс или класс, расширяющий этот класс, используются в объявлении MXML. | AdvancedStyleClient | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Возвращает значение true, если cssState совпадает с currentCSSState. | AdvancedStyleClient | |
|
Определяет, совпадает ли этот экземпляр с данным типом (или является его подклассом). | AdvancedStyleClient | |
|
Применяет изменения стиля к нижестоящим элементам этого экземпляра клиента стиля. | AdvancedStyleClient | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Обеспечивает настройку внутренних значений кэша стиля для функционирования метода getStyle(). | AdvancedStyleClient | |
|
Обеспечивает регистрацию EffectManager в качестве одного из прослушивателей события для каждого события эффекта. | AdvancedStyleClient | |
|
Удаляет прослушиватель из объекта EventDispatcher. | EventDispatcher | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Задает свойство style для экземпляра компонента. | AdvancedStyleClient | |
|
Обеспечивает обнаружение изменений в свойствах стиля. | AdvancedStyleClient | |
|
Метод stylesInitialized() вызывается программой Flex при первой инициализации стиля компонента. | AdvancedStyleClient | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
|
Возвращает строковое представление заданного объекта. | Object | |
|
Выполняет проверку и дополнительно оповещает прослушиватели результата. | GlobalizationValidatorBase | |
| [статические]
Вызывает все средства проверки в массиве validators. | GlobalizationValidatorBase | |
Удобный метод для вызова средства проверки в пользовательской функции проверки. | CurrencyValidator | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
|
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | EventDispatcher | |
Стили являются либо общими, либо связанными с определенной темой. Если стиль общий, он может использоваться с любой темой. Если стиль связан с определенной темой, он может использоваться, только если ваше приложение использует ее.
currencyISOCode | свойство |
currencyISOCode:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Трехбуквенный код валюты ISO 4217 для используемой локали.
Это свойство используется для проверки строки денежной суммы или символа валюты в денежной сумме с помощью метода validate().
Это свойство инициализируется конструктором, исходя из фактически используемой локали. В случае использования резервной локали это свойство отражает предпочитаемый код валюты по умолчанию для резервной локали.
Значение по умолчанию зависит от используемой локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get currencyISOCode():String public function set currencyISOCode(value:String):voidСвязанные элементы API
currencyStringError | свойство |
currencyStringError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Сообщение об ошибке, если символ валюты или код ISO валюты повторяются или находятся в недопустимом местоположении.
Значением по умолчанию является "Currency name is repeated or not correct.".
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get currencyStringError():String public function set currencyStringError(value:String):voidcurrencySymbol | свойство |
currencySymbol:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Символ или строка валюты для используемой локали.
Это свойство используется как символ валюты при проверке денежных сумм с помощью метода validate(). Символ или название валюты в проверяемой строке должны соответствовать значению свойства currencySymbol или currencyISOCode.
Это свойство инициализируется конструктором, исходя из фактически используемой локали. В случае использования резервной локали это свойство отражает предпочитаемый символ валюты по умолчанию для резервной локали.
Значение по умолчанию зависит от используемой локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get currencySymbol():String public function set currencySymbol(value:String):voidСвязанные элементы API
negativeCurrencyFormat | свойство |
negativeCurrencyFormat:uint| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Числовое значение, которое представляет образец проверки для отрицательных денежных сумм. Это свойство определяет местоположение символа валюты и отрицательного символа или круглых скобок относительно числовой части денежной суммы. Это свойство используется для проверки соответствия входной строки валюты этому шаблону для отрицательных денежных сумм.
В качестве значения этого свойства должна использоваться одна из констант, определенная в таблице ниже.
- Символ «¤» обозначает местоположение currencyISOCode или currencySymbol в строке валюты.
- Символ «-» обозначает местоположение negativeNumberSymbol.
- Символ «n» обозначает денежную сумму.
| Тип формата отрицательной денежной суммы | Шаблон форматирования |
| 0 | (¤n) |
| 1 | -¤n |
| 2 | ¤-n |
| 3 | ¤n- |
| 4 | (n¤) |
| 5 | -n¤ |
| 6 | n-¤ |
| 7 | n¤- |
| 8 | -n ¤ |
| 9 | -¤ n |
| 10 | n ¤- |
| 11 | ¤ n- |
| 12 | ¤ -n |
| 13 | n- ¤ |
| 14 | (¤ n) |
| 15 | (n ¤) |
Значение по умолчанию зависит от используемой локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get negativeCurrencyFormat():uint public function set negativeCurrencyFormat(value:uint):voidВыдает
ArgumentError — если присвоенное значение не является числом в диапазоне от 0 до 15.
|
Связанные элементы API
negativeCurrencyFormatError | свойство |
negativeCurrencyFormatError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Сообщение об ошибке, когда формат отрицательного числа в строке вводимой валюты является недействительным.
Значением по умолчанию является "The negative format of the input currency is incorrect.".
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get negativeCurrencyFormatError():String public function set negativeCurrencyFormatError(value:String):voidpositiveCurrencyFormat | свойство |
positiveCurrencyFormat:uint| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Числовое значение, которое представляет образец проверки для положительных денежных сумм. Это свойство определяет местоположение символа валюты относительно числовой части денежной суммы. Это свойство используется для проверки соответствия входной строки валюты этому шаблону для положительных денежных сумм.
В качестве значения этого свойства должна использоваться одна из констант, определенная в таблице ниже.
- Символ «¤» обозначает местоположение
currencyISOCodeилиcurrencySymbolв строке денежной суммы. - Символ «n» обозначает местоположение
currencyISOCodeилиcurrencySymbolв строке денежной суммы.
| Тип формата положительной денежной суммы | Шаблон форматирования |
| 0 | ¤n |
| 1 | n¤ |
| 2 | ¤ n |
| 3 | n ¤ |
Значение по умолчанию зависит от используемой локали и операционной системы.
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get positiveCurrencyFormat():uint public function set positiveCurrencyFormat(value:uint):voidВыдает
ArgumentError — если присвоенное значение не является числом в диапазоне от 0 до 3.
|
Связанные элементы API
positiveCurrencyFormatError | свойство |
positiveCurrencyFormatError:String| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Сообщение об ошибке, когда формат положительного числа валюты является недействительным.
Значением по умолчанию является "The positive format of the input currency is incorrect.".
Это свойство можно использовать в качестве источника для связывания данных. При изменении этого свойства отправляется событие change .
Реализация
public function get positiveCurrencyFormatError():String public function set positiveCurrencyFormatError(value:String):voidCurrencyValidator | () | Конструктор |
public function CurrencyValidator()| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Создает новый объект CurrencyValidator для проверки чисел, представляющих денежные суммы в соответствиями с правилами данной локали.
Локаль для этого класса предоставляется свойством стиля locale. Стиль locale можно установить следующими способами.
-
Наследование стиля из
UIComponentпосредством вызова используемого вUIComponentметодаaddStyleClient. - С использованием класса в объявлении MXML и наследованием локали из документа, содержащего объявление.
<fx:Declarations>
<s:CurrencyValidator id="cv" />
</fx:Declarations>
<fx:Declarations>
<s:CurrencyValidator id="cv_turkish" locale="tr-TR" />
</fx:Declarations>
cv.setStyle("locale", "tr-TR")
Если стиль locale не установлен одним из вышеперечисленных способов, экземпляр этого класса добавляется как StyleClient в topLevelApplication и наследует стиль locale из объекта topLevelApplication при вызове получателя свойств, зависящего от locale, или метода, зависящего от locale.
Для свойств, связанных с форматом строки валюты, устанавливаются значения по умолчанию на основе локали.
ПРИМЕЧАНИЕ. Если используется резервная локаль, для свойств валюты устанавливаются стандартные значения локали en_US, которые могут не соответствовать проверяемой денежной сумме. Перед проверкой денежной суммы рекомендуется проверить значения свойств currencySymbol и currencyISOCode.
Связанные элементы API
validateCurrency | () | метод |
public function validateCurrency(value:Object, baseField:String):Array| Язык версии: | ActionScript 3.0 |
| Версия продукта: | Flex 4.5 |
| Версии среды выполнения: | Flash Player 10.1, AIR 2.5 |
Удобный метод для вызова средства проверки в пользовательской функции проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод. Вызывающий модуль должен проверить объекты ValidationResult в возвращенном массиве для проверки состояния.
Параметры
value:Object — Строка денежной суммы для проверки. Кроме символа «минус» формата ASCII, в числовой строке также могут использоваться такие символы «минус» формата Юникод, как 0x2212, 0xFE63 и 0xFF0D.
| |
baseField:String — Текстовое представление подчиненного поля определяется в параметре value. Например, если параметр value имеет значение value.number, то baseField имеет значение number.
|
Array — Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки.
|
Связанные элементы API
<?xml version="1.0" encoding="utf-8"?>
<!-- Sample program for spark.formatters.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:Declarations>
<s:CurrencyValidator id="currencyValidator" source='{inputNumber}'
property="text" trigger='{validateBtn}'
triggerEvent="click" />
<s:CurrencyFormatter id="currencyFormatter" useCurrencySymbol="true"
useGrouping="true"/>
</fx:Declarations>
<fx:Script>
<![CDATA[
[Bindable]
private var number:Number = 123456789.12;
]]>
</fx:Script>
<mx:Form>
<mx:FormItem label="Input Locale ID Name">
<mx:HBox>
<s:TextInput id="inputLocaleIDName" text="en-US"/>
<!-- Upon button click, sets the locale style on the document
UI component. The formatter will inherit this style. -->
<s:Button click="setStyle('locale', inputLocaleIDName.text);"
label="Apply"/>
</mx:HBox>
<mx:Text text="Example: 'en-US', 'fr-FR', 'ja-JP', 'ar-SA'"/>
</mx:FormItem>
<mx:FormItem label="Allow Negative">
<mx:CheckBox id="alowNegative" selected="true"
change="currencyValidator.allowNegative = alowNegative.selected"/>
</mx:FormItem>
<mx:FormItem label="Fractional Digits">
<mx:TextInput id="fractionalDigits" text='{currencyValidator.fractionalDigits}'
change="currencyFormatter.fractionalDigits =
currencyValidator.fractionalDigits = Number(fractionalDigits.text)"/>
</mx:FormItem>
<mx:FormItem label="Currency Symbol">
<mx:TextInput id="currencySymbol" text='{currencyValidator.currencySymbol}'
change="currencyFormatter.currencySymbol =
currencyValidator.currencySymbol = currencySymbol.text"/>
</mx:FormItem>
<mx:FormItem label="Actual Locale ID Name">
<mx:Text text="{currencyValidator.actualLocaleIDName}"/>
</mx:FormItem>
<mx:FormItem label="Enter currency amount" >
<mx:HBox>
<mx:TextInput id="inputNumber" />
<mx:Button id="validateBtn" label="Validate" />
</mx:HBox>
</mx:FormItem>
<mx:FormItem label="Example currency">
<mx:Text text="{currencyFormatter.format(123456789.12)}"/>
</mx:FormItem>
</mx:Form>
</s:Application>
Tue Jun 12 2018, 11:34 AM Z