MatchingCollator

包	spark.globalization
类	public class MatchingCollator
继承	MatchingCollator CollatorBase GlobalizationBase AdvancedStyleClient EventDispatcher Object

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10.1, AIR 2.5

MatchingCollator 类提供区分区域设置的字符串比较功能并设置用于常规字符串匹配（如在文本块中查找匹配的字）的初始设置。

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

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

查看示例

相关 API 元素

flash.globalization.Collator

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		actualLocaleIDName : String [覆盖] [只读] 由该类对象使用的实际区域设置 ID 的名称。	CollatorBase
		className : String [只读] 组件类的名称。	AdvancedStyleClient
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		id : String 组件的标识。	AdvancedStyleClient
		ignoreCase : Boolean 当此属性设置为 true 时，完全相同的字符串和仅字母大小写不同的字符串比较结果为相等。	CollatorBase
		ignoreCharacterWidth : Boolean 当此属性为 true 时，某些全角和半角形式的中文和日文字符比较结果为相等。	CollatorBase
		ignoreDiacritics : Boolean 当此属性设置为 true 时，使用相同基本字符，但重音符号或其它音调符号不同的字符串，比较结果为相等。	CollatorBase
		ignoreKanaType : Boolean 当此属性设置为 true 时，会将区别仅在于使用了不同的 kana 字符类型的字符串视为相等。	CollatorBase
		ignoreSymbols : Boolean 当此属性设置为 true 时，排序或匹配时将忽略空格、货币符号、数学符号和其它类型符号等符号字符。	CollatorBase
		inheritingStyles : Object 包含该非可视样式客户端实例的可继承样式的对象。	AdvancedStyleClient
		lastOperationStatus : String [覆盖] [只读] 此类对象执行的最近操作的状态。	CollatorBase
		moduleFactory : IFlexModuleFactory 模块工厂作为用于查找样式管理器（控制此非可视样式客户端实例的样式）的上下文使用。	AdvancedStyleClient
		nonInheritingStyles : Object 此组件的非继承样式链的开头内容。	AdvancedStyleClient
		numericComparison : Boolean 控制如何在进行字符串比较期间处理嵌入到字符串的数值。	CollatorBase
		styleDeclaration : CSSStyleDeclaration 具有此对象声明的内嵌样式的样式声明。	AdvancedStyleClient
		styleManager : IStyleManager2 [只读] 返回此组件使用的 StyleManager 实例。	AdvancedStyleClient
		styleName : Object 该对象的样式值的源。	AdvancedStyleClient
		styleParent : IAdvancedStyleClient 组件的父项用于评估后代选择器。	AdvancedStyleClient

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		MatchingCollator() 构造新的 MatchingCollator 对象，以根据指定的区域设置的约定提供字符串比较。	MatchingCollator
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		clearStyle(styleProp:String):void 删除此组件实例的样式属性。	AdvancedStyleClient
		compare(string1:String, string2:String):int 比较两个字符串并返回一个整数值，表示第一个字符串是小于、等于还是大于第二个字符串。	CollatorBase
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		equals(string1:String, string2:String):Boolean 比较两个字符串并返回表示字符串是否相等的布尔值。	CollatorBase
		getAvailableLocaleIDNames():Vector.<String> [静态] 列出此类支持的所有区域设置 ID 名称。	CollatorBase
		getClassStyleDeclarations():Array 为应用于该组件的类型选择器返回 CSSStyleDeclaration 对象数组，如果不存在则返回 null。	AdvancedStyleClient
		getStyle(styleProp:String):* [覆盖] 获取已在此组件的样式查找链中的某个位置设置过的样式属性。	GlobalizationBase
		hasCSSState():Boolean 如果 currentCSSState 不为 null，则返回 true。	AdvancedStyleClient
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		initialized(document:Object, id:String):void 该类或扩展该类的类在 MXML 声明中使用时，调用 initialized 方法。	AdvancedStyleClient
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		matchesCSSState(cssState:String):Boolean 如果 cssState 与 currentCSSState 匹配，则返回 true。	AdvancedStyleClient
		matchesCSSType(cssType:String):Boolean 确定此实例与给定类型相同，还是属于给定类型的子类。	AdvancedStyleClient
		notifyStyleChangeInChildren(styleProp:String, recursive:Boolean):void 将样式更改传播到此样式客户端实例的子项。	AdvancedStyleClient
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		regenerateStyleCache(recursive:Boolean):void 设置内部样式缓存值，以便 getStyle() 方法可以起作用。	AdvancedStyleClient
		registerEffects(effects:Array):void 将 EffectManager 注册为每个效果事件的事件侦听器之一。	AdvancedStyleClient
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setStyle(styleProp:String, newValue:*):void 对此组件实例设置样式属性。	AdvancedStyleClient
		styleChanged(styleProp:String):void 检测对样式属性的更改。	AdvancedStyleClient
		stylesInitialized():void 首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。	AdvancedStyleClient
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
change	当区域设置样式发生改变，或设置了其它属性，导致改变数字的格式或更新到此类中所允许的其它值时，将生成更改事件。	GlobalizationBase
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher

样式

样式为常见样式，或与特定主题关联。如果为常见样式，则可以用于任何主题。如果样式与特定主题关联，则只有应用程序使用该主题时才能使用该样式。

常见样式

单击此处了解有关样式的更多信息

隐藏继承的样式

显示继承的样式

	样式		说明	由以下参数定义
		locale	类型: String CSS 继承: 是语言版本: ActionScript 3.0 产品版本: Flex 4.5 运行时版本: Flash10.1, AIR 2.5 区域设置标识符，用于指定语言、区域、脚本，还可以指定其它相关的标签和键.	GlobalizationBase

构造函数详细信息

()

构造函数

public function MatchingCollator()

语言版本:

ActionScript 3.0

产品版本:

Flex 4.5

运行时版本:

Flash Player 10.1, AIR 2.5

构造新的 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 样式。

MatchingCollator - AS3 Flex

类 x

MatchingCollator