spark.validatorsCurrencyValidator Класс CurrencyValidator обеспечивает представление действительной денежной суммы в строке согласно соглашениям локали.The <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."
  />
  
]]>
spark.validators.supportClasses:NumberValidatorBase Класс CurrencyValidator обеспечивает представление элементом String действительной суммы денежных средств в соответствии с условиями локали. Этот класс использует стиль locale для указания Locale ID.

Средство проверки гарантирует, что строка денежной суммы соответствует указанному диапазону (определяется свойствами minValue и maxValue), является целым числом (определяется свойством domain), является неотрицательным числом (определяется свойством allowNegative), правильно указывает отрицательные и положительные числа, содержит правильный код ISO или символ валюты и не превышает указанное значение fractionalDigits. Поскольку средство проверки устанавливает стандартные значения свойств с помощью класса flash.globalization.CurrencyFormatter, значения на основе локалей предоставляет операционная система.

Класс flash.globalization.CurrencyFormatter использует базовую операционную систему для предоставления данных на основе локалей. Если операционная система не поддерживает форматирование денежных сумм, этот класс предоставляет резервные функциональные возможности.

flash.globalization.CurrencyFormatterCurrencyValidator Создает новый объект CurrencyValidator для проверки чисел, представляющих денежные суммы в соответствии с правилами данной локали. Создает новый объект CurrencyValidator для проверки чисел, представляющих денежные суммы в соответствиями с правилами данной локали.

Локаль для этого класса предоставляется свойством стиля locale. Стиль locale можно установить следующими способами.

  • Наследование стиля из UIComponent посредством вызова используемого в UIComponent метода addStyleClient.
  • С использованием класса в объявлении MXML и наследованием локали из документа, содержащего объявление.
  •       <fx:Declarations>
                 <s:CurrencyValidator id="cv" />
          </fx:Declarations>
          
  • С использованием объявления MXML и указанием значения локали в списке назначений.
  •       <fx:Declarations>
              <s:CurrencyValidator id="cv_turkish" locale="tr-TR" />
          </fx:Declarations>
          
  • Вызов метода setStyle, например cv.setStyle("locale", "tr-TR")

Если стиль locale не установлен одним из вышеперечисленных способов, экземпляр этого класса добавляется как StyleClient в topLevelApplication и наследует стиль locale из объекта topLevelApplication при вызове получателя свойств, зависящего от locale, или метода, зависящего от locale.

Для свойств, связанных с форматом строки валюты, устанавливаются значения по умолчанию на основе локали.

ПРИМЕЧАНИЕ. Если используется резервная локаль, для свойств валюты устанавливаются стандартные значения локали en_US, которые могут не соответствовать проверяемой денежной сумме. Перед проверкой денежной суммы рекомендуется проверить значения свойств currencySymbol и currencyISOCode.

flash.globalization.CurrencyFormatter.actualLocaleIDName
validateCurrency Удобный метод для вызова средства проверки в пользовательской функции проверки.Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки. valueСтрока денежной суммы для проверки. Кроме символа «минус» формата ASCII, в числовой строке также могут использоваться такие символы «минус» формата Юникод, как 0x2212, 0xFE63 и 0xFF0D. baseFieldТекстовое представление подчиненного поля определяется в параметре value. Например, если параметр value имеет значение value.number, то baseField имеет значение number. Удобный метод для вызова средства проверки в пользовательской функции проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод. Вызывающий модуль должен проверить объекты ValidationResult в возвращенном массиве для проверки состояния. mx.validators.ValidationResultflash.globalization.CurrencyFormattercurrencyISOCode Трехбуквенный код валюты ISO 4217 для используемой локали. Трехбуквенный код валюты ISO 4217 для используемой локали.

Это свойство используется для проверки строки денежной суммы или символа валюты в денежной сумме с помощью метода validate().

Это свойство инициализируется конструктором, исходя из фактически используемой локали. В случае использования резервной локали это свойство отражает предпочитаемый код валюты по умолчанию для резервной локали.

Значение по умолчанию зависит от используемой локали и операционной системы.

validate()currencySymbol
currencyStringError Сообщение об ошибке, если символ валюты или код ISO валюты повторяются или находятся в недопустимом местоположении."Currency name is repeated or not correct." Сообщение об ошибке, если символ валюты или код ISO валюты повторяются или находятся в недопустимом местоположении. currencySymbol Символ или строка валюты для используемой локали. Символ или строка валюты для используемой локали.

Это свойство используется как символ валюты при проверке денежных сумм с помощью метода validate(). Символ или название валюты в проверяемой строке должны соответствовать значению свойства currencySymbol или currencyISOCode.

Это свойство инициализируется конструктором, исходя из фактически используемой локали. В случае использования резервной локали это свойство отражает предпочитаемый символ валюты по умолчанию для резервной локали.

Значение по умолчанию зависит от используемой локали и операционной системы.

format()setCurrency()formattingWithCurrencySymbolIsSafe()currencyISOCode
negativeCurrencyFormatError Сообщение об ошибке, когда формат отрицательного числа в строке вводимой валюты является недействительным."The negative format of the input currency is incorrect." Сообщение об ошибке, когда формат отрицательного числа в строке вводимой валюты является недействительным. negativeCurrencyFormat Числовое значение, которое представляет образец проверки для отрицательных денежных сумм.если присвоенное значение не является числом в диапазоне от 0 до 15. ArgumentErrorArgumentError Числовое значение, которое представляет образец проверки для отрицательных денежных сумм. Это свойство определяет местоположение символа валюты и отрицательного символа или круглых скобок относительно числовой части денежной суммы. Это свойство используется для проверки соответствия входной строки валюты этому шаблону для отрицательных денежных сумм.

В качестве значения этого свойства должна использоваться одна из констант, определенная в таблице ниже.

  • Символ «¤» обозначает местоположение 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 ¤)

Значение по умолчанию зависит от используемой локали и операционной системы.

format()currencySymbolnegativeSymbol
positiveCurrencyFormatError Сообщение об ошибке, когда формат положительного числа валюты является недействительным."The positive format of the input currency is incorrect." Сообщение об ошибке, когда формат положительного числа валюты является недействительным. positiveCurrencyFormat Числовое значение, которое представляет образец проверки для положительных денежных сумм.если присвоенное значение не является числом в диапазоне от 0 до 3. ArgumentErrorArgumentError Числовое значение, которое представляет образец проверки для положительных денежных сумм. Это свойство определяет местоположение символа валюты относительно числовой части денежной суммы. Это свойство используется для проверки соответствия входной строки валюты этому шаблону для положительных денежных сумм.

В качестве значения этого свойства должна использоваться одна из констант, определенная в таблице ниже.

  • Символ «¤» обозначает местоположение currencyISOCode или currencySymbol в строке денежной суммы.
  • Символ «n» обозначает местоположение currencyISOCode или currencySymbolв строке денежной суммы.
Тип формата положительной денежной суммы Шаблон форматирования 0 ¤n 1 2 ¤ n 3 n ¤

Значение по умолчанию зависит от используемой локали и операционной системы.

currencySymbolformat()
NumberValidator С помощью класса NumberValidator элемент String представляет действительное число в соответствии с условиями локали.The <spark:NumberValidator> tag inherits all of the tag attributes of its superclass, and adds the following tag attributes:

  <s:NumberValidator
    Properties
    negativeNumberFormat="locale specified string or customized by user."
    negativeNumberFormatError="The negative format of the input number is incorrect."
  />
  
]]>
spark.validators.supportClasses:NumberValidatorBase С помощью класса NumberValidator элемент String представляет действительное число в соответствии с условиями локали. Он может выполнять проверку строк, представляющих объекты int, uint и Number.

Этот класс использует стиль locale для указания запрашиваемого идентификатора локали.

Средство проверки гарантирует, что введенное число соответствует указанному диапазону (определяется свойствами minValue и maxValue), является целым числом (определяется свойством domain), является неотрицательным числом (определяется свойством allowNegative), правильно указывает отрицательные и положительные числа и не превышает указанное количество fractionalDigits. Поскольку средство проверки устанавливает стандартные значения свойств с помощью класса flash.globalization.NumberFormatter, значения на основе локалей предоставляет операционная система.

Класс NumberValidator можно использовать в объявлениях MXML или коде ActionScript. Этот класс использует стиль локали для указания запрашиваемого Locale ID, который требуется для класса flash.globalization.NumberFormatter и содержит привязываемые методы и свойства.

flash.globalization.NumberFormatterNumberValidator Создает новый объект NumberValidator для проверки чисел в соответствии с правилами данной локали. Создает новый объект NumberValidator для проверки чисел в соответствии с правилами данной локали.

Стиль locale определяет локаль для этого класса. Стиль locale можно установить следующими способами.

  • Наследование стиля из UIComponent посредством вызова используемого в UIComponent метода addStyleClient.
  • С использованием класса в объявлении MXML и наследованием локали из документа, содержащего объявление.
          <fx:Declarations>
                 <s:NumberValidator id="nv" />
          </fx:Declarations>
          
  • С использованием объявления MXML и указанием значения локали в списке назначений.
          <fx:Declarations>
              <s:NumberValidator id="nv_French_France" locale="fr_FR" />
          </fx:Declarations>
          
  • Вызов метода setStyle. Например, nv.setStyle("locale", "fr-FR")

Если стиль locale не установлен одним из вышеперечисленных способов, экземпляр этого класса добавляется как StyleClient в topLevelApplication и наследует стиль locale из объекта topLevelApplication при вызове получателя свойств, зависящего от locale, или метода, зависящего от locale.

validateNumber Удобный метод для вызова средства проверки в пользовательской функции проверки.Массив объектов ValidationResult с одним объектом ValidationResult для каждого поля, проверенного средством проверки. valueЧисловая строка, которую необходимо проверить. baseFieldТекстовое представление подчиненного поля определяется в объекте value. Например, если параметр value имеет значение value.number, то baseField имеет значение number. Удобный метод для вызова средства проверки в пользовательской функции проверки. Каждое стандартное средство проверки Flex имеет подобный удобный метод. Вызывающий модуль должен проверить объекты ValidationResult в возвращенном массиве для проверки состояния. mx.validators.ValidationResultnegativeNumberFormatError Сообщение об ошибке, когда используемый формат отрицательного числа не соответствует шаблону, определенному в свойстве negativeNumberFormat."The negative format of the input number is incorrect." Сообщение об ошибке, когда используемый формат отрицательного числа не соответствует шаблону, определенному в свойстве negativeNumberFormat. negativeNumberFormat Числовое значение, которое представляет образец проверки для отрицательных чисел.если присвоенное значение не является числом в диапазоне от 0 до 4. ArgumentErrorArgumentError Числовое значение, которое представляет образец проверки для отрицательных чисел. Этот шаблон определяет местоположение отрицательного символа или круглых скобок относительно числовой части проверяемого числа.

В следующей таблице сведены все возможные форматы отрицательных чисел. При проверке отрицательного числа знак минуса обозначает значение свойства negativeSymbol, а символ "n" – числовое значение.

Тип формата отрицательного числа Формат 0 (n) 1 -n 2 - n 3 n- 4 n - Значение по умолчанию зависит от используемой локали и операционной системы.
negativeSymbolformat()