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 类确保字符串根据区域设置约定表示有效的货币金额。该类使用 locale 样式以指定区域设置 ID。

验证程序可以确保货币字符串属于给定范围（由 minValue 和 maxValue 属性指定），是一个整数（由 domain 属性指定），是一个非负数（由 allowNegative 属性指定），正确指定负数和正数，具有正确的货币 ISO 代码或货币符号，以及不超过 fractionalDigits 的指定数字。验证程序通过使用 flash.globalization.CurrencyFormatter 类设置默认属性值，因此区域设置特定的值由操作系统提供。

flash.globalization.CurrencyFormatter 类使用基础操作系统来提供区域设置特定的数据。如果操作系统未提供货币格式，该类将提供回退功能。

flash.globalization.CurrencyFormatterCurrencyValidator 构造新的 CurrencyValidator 对象以根据给定区域设置的约定验证表示货币金额的数字。 构造新的 CurrencyValidator 对象以根据给定区域设置的约定验证表示货币金额的数字。

此类的区域设置由区域设置样式属性提供。可以使用下列方法来设置区域设置样式：

  • 调用 UIComponent 的 addStyleClient 方法，从 UIComponent 继承样式。
  • 在 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 从属属性 getter 或 locale 从属方法时，会从 topLevelApplication 对象中继承 locale 样式。

与货币字符串格式相关的属性会基于区域设置设置为默认值。

注意：在使用回退区域设置时，货币属性将设置为 en_US 区域设置的默认值，这可能会与验证过程所预期的货币不匹配。在验证货币金额前，最好先检查 currencySymbol 和 currencyISOCode 属性值。

flash.globalization.CurrencyFormatter.actualLocaleIDNamevalidateCurrency 用于从自定义验证函数内调用验证程序的方便方法。ValidationResult 对象的数组，验证程序检查的每个字段都有一个 ValidationResult 对象。 value要验证的货币数字字符串。除 ascii 减号外，该数字字符串还可以使用 unicode 减号 0x2212、0xFE63、0xFF0D。 baseField在 value 参数中指定的子字段的文本表示形式。例如，如果 value 参数指定 value.number，则 baseField 值为“number”。 用于从自定义验证函数内调用验证程序的方便方法。每个标准 Flex 验证程序都有一个类似的方便方法。调用者必须检查在返回的数组中的 ValidationResult 对象以获取验证状态。 mx.validators.ValidationResultflash.globalization.CurrencyFormattercurrencyISOCode 正在使用的区域设置的三字母 ISO 4217 币种代码。 正在使用的区域设置的三字母 ISO 4217 币种代码。

该属性用于使用 validate() 方法验证在输入货币金额中显示的货币字符串或符号。

此属性由构造函数基于所使用的实际区域设置进行初始化。当使用回退区域设置时，此属性反映回退区域设置的首选币种代码、默认币种代码。

默认值取决于实际区域设置和操作系统。

validate()currencySymbolcurrencyStringError 当货币符号或货币 ISO 代码重复或位于不正确的位置时将显示的错误消息。"Currency name is repeated or not correct." 当货币符号或货币 ISO 代码重复或位于不正确的位置时将显示的错误消息。 currencySymbol 正在使用的区域设置的货币符号或字符串。 正在使用的区域设置的货币符号或字符串。

在使用 validate() 方法验证货币金额时该属性用作货币符号。验证字符串中的货币符号或货币名称必须匹配 currencySymbol 属性的值或 currencyISOCode 属性的值。

此属性由构造函数基于所使用的实际区域设置进行初始化。当使用回退区域设置时，此属性反映回退区域设置的首选货币符号、默认货币符号。

默认值取决于实际区域设置和操作系统。

format()setCurrency()formattingWithCurrencySymbolIsSafe()currencyISOCodenegativeCurrencyFormatError 当所输入的货币字符串的负数格式不正确时将显示的错误消息。"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()currencySymbolnegativeSymbolpositiveCurrencyFormatError 当货币金额的正数格式不正确时将显示的错误消息。"The positive format of the input currency is incorrect." 当货币金额的正数格式不正确时将显示的错误消息。 positiveCurrencyFormat 数值，用于指示正数货币金额的验证模式。如果指定的值不介于 0 到 3 之间。 ArgumentErrorArgumentError 数值，用于指示正数货币金额的验证模式。此属性定义货币符号相对于货币金额数值部分的位置。该属性用于验证所输入的货币字符串是否符合正数金额的模式。

此属性的值必须是在下表中定义的常量之一。

  • “¤”符号表示 currencyISOCode 或 currencySymbol 在货币字符串中的位置。
  • “n”字符表示 currencyISOCode 或 currencySymbol 在货币字符串中的位置。
正值货币格式类型 格式化图案 0 ¤n 1 n¤ 2 ¤ n 3 n ¤

默认值取决于实际区域设置和操作系统。

currencySymbolformat()NumberValidator NumberValidator 类确保字符串根据区域设置约定表示有效的数字。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 类确保字符串根据区域设置约定表示有效的数字。它可以验证表示 int、uint 和 Number 对象的字符串。

该类使用 locale 样式以指定请求的区域设置 ID。

验证程序可以确保输入属于给定范围（由 minValue 和 maxValue 属性指定），是一个整数（由 domain 属性指定），是一个非负数（由 allowNegative 属性指定），正确指定负数和正数，以及不超过 fractionalDigits 的指定数字。验证程序通过使用 flash.globalization.NumberFormatter 设置默认属性值，因此区域设置特定的值由操作系统提供。

NumberValidator 类可以在 MXML 声明或 ActionScript 代码中使用。该类使用区域设置样式来指定 flash.globalization.NumberFormatter 类所需的、请求的区域设置 ID，并且具有可绑定的方法和属性。

flash.globalization.NumberFormatterNumberValidator 构造新的 NumberValidator 对象以根据给定区域设置的约定验证数字。 构造新的 NumberValidator 对象以根据给定区域设置的约定验证数字。

此类的区域设置由区域设置样式提供。可以使用下列方法来设置区域设置样式：

  • 调用 UIComponent 的 addStyleClient 方法，从 UIComponent 继承样式。
  • 在 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 从属属性 getter 或 locale 从属方法时，会从 topLevelApplication 对象中继承 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()