spark.globalizationSortingCollator SortingCollator 类提供区分区域设置的字符串比较功能并设置用于按照语言来进行排序(例如对显示给最终用户的文本字符串列表进行排序)的初始设置。spark.globalization.supportClasses:CollatorBase SortingCollator 类提供区分区域设置的字符串比较功能并设置用于按照语言来进行排序(例如对显示给最终用户的文本字符串列表进行排序)的初始设置。

此类是包装 flash.globalization.Collator 的包装器类。因此,特定于区域设置的字符串比较是由 flash.globalization.Collator 提供的。但是,此 SortingCollator 类可在 MXML 声明中使用,为请求的区域设置 ID 名称使用区域设置样式,并具有可绑定的方法和属性。此外,当 flash.globalization 类发生错误或警告时,将设置 LastOperationStatus

flash.globalization.Collator 类使用基础操作系统来实现格式化功能并提供特定于区域设置的数据。某些操作系统不支持 flash.globalization 类,此时由包装器类提供回退功能。

flash.globalization.CollatorSortingCollator 构造新的 SortingCollator 对象,以根据指定的区域设置的约定提供字符串比较。 构造新的 SortingCollator 对象,以根据指定的区域设置的约定提供字符串比较。

此类设置用于常规语言排序(例如对显示给最终用户的文本字符串列表进行排序)的各种排序规则选项的初始值。在此模式下,进行字符串比较时考虑大写和小写字母、重音符号及其它特定于区域设置的区别。

此类的实例所提供的比较等效于构造 flash.globalization.Collator 的实例并将其 initialMode 参数设置为 CollatorMode.SORTING。有关此模式的详细信息和示例,请参阅有关 flash.globalization.Collator 类的文档。

此类的区域设置是由区域设置样式提供的。可以使用以下几种方法来设置区域设置样式:

  • 调用 UIComponent 的 addStyleClient 方法,从 UIComponent 继承样式。
  • 在 MXML 声明中使用该类,并从包含声明的文档中继承区域设置。
          Example:
          <fx:Declarations>
                 <s:SortingCollator id="sc" />
          </fx:Declarations>
          
  • 使用 MXML 声明并在赋值列表中指定区域设置值。
          Example:
          <fx:Declarations>
              <s:SortingCollator id="sc_France" locale="fr-FR" />
          </fx:Declarations>
          
  • 调用 setStyle 方法,如 sc.setStyle("locale", "fr-FR")

如果 locale 样式不是由以上方式之一设置的,则该类的实例会作为 StyleClient 添加至 topLevelApplication 中,并因此在调用 locale 从属属性 getter 或 locale 从属方法时,会从 topLevelApplication 对象中继承 locale 样式。

flash.globalization.Collator
StringTools StringTools 类提供区分区域设置的大小写转换方法。spark.globalization.supportClasses:GlobalizationBase StringTools 类提供区分区域设置的大小写转换方法。

此类是包装 flash.globalization.StringTools 的包装器类。因此,大小写转换功能是由 flash.globalization.StringTools 类提供的。但是,此 StringTools 类可在 MXML 声明中使用,为请求的区域设置 ID 名称使用区域设置样式,并具有可绑定的方法和属性。此外,当 flash.globalization 类发生错误或警告时,将生成事件。

flash.globalization.StringTools 类使用基础操作系统来实现大小写转换功能,某些操作系统不支持 flash.globalization 类,此时由包装器类提供回退功能,使用由 String 类提供的大小写转换功能。

flash.globalization.StringToolsStringTools 构造新的 StringTools 对象,用于根据给定区域设置的约定提供大小写转换和其它实用程序。 构造新的 StringTools 对象,用于根据给定区域设置的约定提供大小写转换和其它实用程序。此类的区域设置是由区域设置样式提供的。可以使用以下几种方法来设置区域设置样式:
  • 调用 UIComponent 的 addStyleClient 方法,从 UIComponent 继承样式。
  • 在 MXML 声明中使用该类,并从包含声明的文档中继承区域设置。示例:
          <fx:Declarations>
                 <s:StringTools id="st" />
          </fx:Declarations>
          
  • 使用 MXML 声明并在赋值列表中指定区域设置值。示例:
          <fx:Declarations>
              <s:StringTools id="st_turkish" locale="tr-TR" />
          </fx:Declarations>
          
  • 调用 setStyle 方法,如 st.setStyle("locale", "tr-TR")

如果 locale 样式不是由以上方式之一设置的,则该类的实例会作为 StyleClient 添加至 topLevelApplication 中,并因此在调用 locale 从属属性 getter 或 locale 从属方法时,会从 topLevelApplication 对象中继承 locale 样式。

flash.globalization.StringTools
getAvailableLocaleIDNames 一个字符串矢量,其中包含此类和操作系统所支持的所有区域设置 ID 名称。 toLowerCase 根据语言约定将字符串转换为小写形式。转换后的小写形式字符串。 s要转换为小写形式的字符串 根据语言约定将字符串转换为小写形式。根据区域设置,输出字符串长度可能与输入字符串长度不同。 flash.globalization.StringToolstoUpperCase 根据语言约定将字符串转换为大写形式。转换后的大写形式字符串。 s要转换为大写形式的字符串 根据语言约定将字符串转换为大写形式。根据区域设置,输出字符串长度可能与输入字符串长度不同。 flash.globalization.StringToolsactualLocaleIDName 由该类对象使用的实际区域设置 ID 的名称。 由该类对象使用的实际区域设置 ID 的名称。这是用于从操作系统访问格式化数据和功能的区域设置。

如果由 locale 样式所设置的区域设置不可用,则 actualLocaleIDName 的值将不同于 locale 样式的值。它指明正在使用的回退区域设置。如果区域设置样式设置为 LocaleID.DEFAULT,将使用由用户的操作系统指定的区域设置的名称。

flash.globalization.StringTools.actualLocaleIDNameStringTools()
lastOperationStatus 此类对象执行的最近操作的状态。 此类对象执行的最近操作的状态。只要调用构造函数或此类的一个方法,或设置一个属性,都会设置 lastOperationStatus。有关可能值的信息,请参阅每种方法下的说明。
MatchingCollator MatchingCollator 类提供区分区域设置的字符串比较功能并设置用于常规字符串匹配(如在文本块中查找匹配的字)的初始设置。spark.globalization.supportClasses:CollatorBase MatchingCollator 类提供区分区域设置的字符串比较功能并设置用于常规字符串匹配(如在文本块中查找匹配的字)的初始设置。

此类是包装 flash.globalization.Collator 的包装器类。因此,特定于区域设置的字符串比较是由 flash.globalization.Collator 提供的。但是,此 MatchingCollator 类可在 MXML 声明中使用,为请求的区域设置 ID 名称使用区域设置样式,并具有可绑定的方法和属性。此外,当 flash.globalization 类发生错误或警告时,将设置 LastOperationStatus

flash.globalization.Collator 类使用基础操作系统来实现格式化功能并提供特定于区域设置的数据。某些操作系统不支持 flash.globalization 类,此时由包装器类提供回退功能。

flash.globalization.CollatorMatchingCollator 构造新的 MatchingCollator 对象,以根据指定的区域设置的约定提供字符串比较。 构造新的 MatchingCollator 对象,以根据指定的区域设置的约定提供字符串比较。

此类设置用于常规字符串匹配(例如确定两个字符串是否相等,或在文本块中查找匹配的字)的各种排序规则的初始值。在此模式下,进行字符串比较时忽略大写和小写字母、重音符号等区别。

此类的实例所提供的比较等效于构造 flash.globalization.Collator 的实例并将其 initialMode 参数设置为 CollatorMode.MATCHING。有关此模式的详细信息和示例,请参阅有关 flash.globalization.Collator 类的文档。

此类的区域设置是由区域设置样式提供的。可以使用以下几种方法来设置区域设置样式:

  • 调用 UIComponent 的 addStyleClient 方法,从 UIComponent 继承样式。
  • 在 MXML 声明中使用该类,并从包含声明的文档中继承区域设置。
          Example:
          <fx:Declarations>
                 <s:MatchingCollator id="mc" />
          </fx:Declarations>
          
  • 使用 MXML 声明并在赋值列表中指定区域设置值。
          Example:
          <fx:Declarations>
              <s:MatchingCollator id="mc_France" locale="fr-FR" />
          </fx:Declarations>
          
  • 调用 setStyle 方法,如 mc.setStyle("locale", "fr-FR")

如果 locale 样式不是由以上方式之一设置的,则该类的实例会作为 StyleClient 添加至 topLevelApplication 中,并因此在调用 locale 从属属性 getter 或 locale 从属方法时,会从 topLevelApplication 对象中继承 locale 样式。

flash.globalization.Collator
LastOperationStatus LastOperationStatus 类枚举那些表示最近的全球化服务操作的状态的常量值。Object LastOperationStatus 类枚举那些表示最近的全球化服务操作的状态的常量值。这些值可通过在大多数全球化类中可用的只读属性 lastOperationStatus 检索。 flash.globalization.LastOperationStatusBUFFER_OVERFLOW_ERROR 表示给定的缓冲区不足以容纳结果。bufferOverflowError 表示给定的缓冲区不足以容纳结果。 flash.globalization.LastOperationStatus.BUFFER_OVERFLOW_ERRORERROR_CODE_UNKNOWN 表示返回的错误代码未知。errorCodeUnknown 表示返回的错误代码未知。当操作失败且返回的错误代码未知时,任何非静态方法或读取/写入属性都可返回此错误。 flash.globalization.LastOperationStatus.ERROR_CODE_UNKNOWNILLEGAL_ARGUMENT_ERROR 表示传递给方法的参数是非法的。illegalArgumentError 表示传递给方法的参数是非法的。

例如,下列代码显示当 CurrencyFormatter.grouping 属性设置为无效值“3;”时,设置了无效的参数错误状态。

      var cf:CurrencyFormatter = new CurrencyFormatter();
      cf.setStyle("locale","en_US");
      cf.groupingPattern = "3;";
      trace(cf.lastOperationStatus); // "illegalArgumentError"
      
flash.globalization.LastOperationStatus.ILLEGAL_ARGUMENT_ERROR
INDEX_OUT_OF_BOUNDS_ERROR 表示迭代器超出范围或者为月、日或时间指定的参数无效。indexOutOfBoundsError 表示迭代器超出范围或者为月、日或时间指定的参数无效。 flash.globalization.LastOperationStatus.INDEX_OUT_OF_BOUNDS_ERRORINVALID_ATTR_VALUE 表示给定的属性值超出了预期的范围。invalidAttrValue 表示给定的属性值超出了预期的范围。

下面的示例显示将 NumberFormatter.negativeNumberFormat 属性设置为超出范围的值会导致属性值状态无效。

      var nf:NumberFormatter = new NumberFormatter();
      nf.setStyle("locale","en_US");
      nf.negativeNumberFormat = 9;
      nf.lastOperationStatus; // "invalidAttrValue"
      
flash.globalization.LastOperationStatus.INVALID_ATTR_VALUE
INVALID_CHAR_FOUND 表示找到无效的 Unicode 值。invalidCharFound 表示找到无效的 Unicode 值。 flash.globalization.LastOperationStatus.INVALID_CHAR_FOUNDLOCALE_UNDEFINED_ERROR 指示未定义区域设置。localeUndefinedError 指示未定义区域设置MEMORY_ALLOCATION_ERROR 表示内存分配已失败。memoryAllocationError 表示内存分配已失败。 flash.globalization.LastOperationStatus.MEMORY_ALLOCATION_ERRORNO_ERROR 表示上一操作成功,未出现任何错误。noError 表示上一操作成功,未出现任何错误。此状态可由所有构造函数、非静态方法、静态方法和读取/写入属性返回。 flash.globalization.LastOperationStatus.NO_ERRORNUMBER_OVERFLOW_ERROR 表示操作产生的值超出指定的数字类型。numberOverflowError 表示操作产生的值超出指定的数字类型。 flash.globalization.LastOperationStatus.NUMBER_OVERFLOW_ERRORPARSE_ERROR 表示解析数字失败。parseError 表示解析数字失败。此状态可由 formatter 类的解析方法(如 CurrencyFormatter.parse()NumberFormatter.parseNumber())返回。例如,如果值“12abc34”作为参数传递到 CurrencyFormatter.parse() 方法,此方法返回“NaN”,并将 lastOperationStatus 值设置为 LastOperationStatus.PARSE_ERRORflash.globalization.LastOperationStatus.PARSE_ERRORPATTERN_SYNTAX_ERROR 表示设置数字、日期或时间格式所用的模式无效。patternSyntaxError 表示设置数字、日期或时间格式所用的模式无效。如果用户的操作系统不支持指定的模式,则设置此状态。

例如,下列代码显示在使用无效的“xx”模式设置日期格式后 lastOperationStatus 属性的值:

      var df:DateTimeFormatter = new DateTimeFormatter();
      df.setStyle("locale","en_US");
      df.setDateTimePattern("xx");
      trace(df.lastOperationStatus); // "patternSyntaxError"
      
flash.globalization.LastOperationStatus.PATTERN_SYNTAX_ERROR
PLATFORM_API_FAILED 表示基础平台 API 执行某操作失败。platformAPIFailed 表示基础平台 API 执行某操作失败。 flash.globalization.LastOperationStatus.PLATFORM_API_FAILEDTRUNCATED_CHAR_FOUND 表示找到截断的 Unicode 字符值。truncatedCharFound 表示找到截断的 Unicode 字符值。 flash.globalization.LastOperationStatus.TRUNCATED_CHAR_FOUNDUNEXPECTED_TOKEN 表示在区域设置 ID 字符串中检测到意外的标记。unexpectedToken 表示在区域设置 ID 字符串中检测到意外的标记。

例如,以下代码显示在请求区域设置 ID 时使用不完整的字符串后 lastOperationStatus 属性的值。结果,在调用 LocaleID.getKeysAndValues() 方法后,lastOperationStatus 属性设为值 UNEXPECTED_TOKEN

      var locale:flash.globalization.LocaleID = new flash.globalization.LocaleID("en-US@Collation");
      var kav:Object = locale.getKeysAndValues();
      trace(locale.lastOperationStatus); // "unexpectedToken"
      
flash.globalization.LastOperationStatus.UNEXPECTED_TOKEN
UNSUPPORTED_ERROR 表示不支持请求的操作或选项。unsupportedError 表示不支持请求的操作或选项。此状态可由 DateTimeFormatter.setDateTimePattern() 等方法以及在检索 Collator.ignoreCase 等属性时返回。 flash.globalization.LastOperationStatus.UNSUPPORTED_ERRORUSING_DEFAULT_WARNING 表示在最近操作期间使用了操作系统默认值。usingDefaultWarning 表示在最近操作期间使用了操作系统默认值。Class 构造函数可以返回此状态。 flash.globalization.LastOperationStatus.USING_DEFAULT_WARNINGUSING_FALLBACK_WARNING 表示在最近操作期间设置了回退值。usingFallbackWarning 表示在最近操作期间设置了回退值。此状态可由 DateTimeFormatter.setDateTimeStyles() 等构造函数和方法以及在检索 CurrencyFormatter.groupingPattern 等属性时返回。 flash.globalization.LastOperationStatus.USING_FALLBACK_WARNING