| 包 | spark.globalization |
| 类 | public class StringTools |
| 继承 | StringTools  GlobalizationBase AdvancedStyleClient EventDispatcher Object |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.5 |
StringTools 类提供区分区域设置的大小写转换方法。
此类是包装 flash.globalization.StringTools 的包装器类。因此，大小写转换功能是由 flash.globalization.StringTools 类提供的。但是，此 StringTools 类可在 MXML 声明中使用，为请求的区域设置 ID 名称使用区域设置样式，并具有可绑定的方法和属性。此外，当 flash.globalization 类发生错误或警告时，将生成事件。
flash.globalization.StringTools 类使用基础操作系统来实现大小写转换功能，某些操作系统不支持 flash.globalization 类，此时由包装器类提供回退功能，使用由 String 类提供的大小写转换功能。
相关 API 元素
公共属性
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| actualLocaleIDName : String [覆盖] [只读]
由该类对象使用的实际区域设置 ID 的名称。 | StringTools | ||
 | className : String [只读]
组件类的名称。 | AdvancedStyleClient | |
| constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| id : String
组件的标识。 | AdvancedStyleClient | |
| inheritingStyles : Object
包含该非可视样式客户端实例的可继承样式的对象。 | AdvancedStyleClient | |
| lastOperationStatus : String [覆盖] [只读]
此类对象执行的最近操作的状态。 | StringTools | ||
| moduleFactory : IFlexModuleFactory
模块工厂作为用于查找样式管理器（控制此非可视样式客户端实例的样式）的上下文使用。 | AdvancedStyleClient | |
| nonInheritingStyles : Object
此组件的非继承样式链的开头内容。 | AdvancedStyleClient | |
| styleDeclaration : CSSStyleDeclaration
具有此对象声明的内嵌样式的样式声明。 | AdvancedStyleClient | |
| styleManager : IStyleManager2 [只读]
返回此组件使用的 StyleManager 实例。 | AdvancedStyleClient | |
| styleName : Object
该对象的样式值的源。 | AdvancedStyleClient | |
| styleParent : IAdvancedStyleClient
组件的父项用于评估后代选择器。 | AdvancedStyleClient | |
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
构造新的 StringTools 对象，用于根据给定区域设置的约定提供大小写转换和其它实用程序。 | StringTools | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
|
删除此组件实例的样式属性。 | AdvancedStyleClient | |
|
将事件调度到事件流中。 | EventDispatcher | |
[静态]
列出此类支持的所有区域设置 ID 名称。 | StringTools | ||
|
为应用于该组件的类型选择器返回 CSSStyleDeclaration 对象数组，如果不存在则返回 null。 | AdvancedStyleClient | |
| [覆盖]
获取已在此组件的样式查找链中的某个位置设置过的样式属性。 | GlobalizationBase | |
|
如果 currentCSSState 不为 null，则返回 true。 | AdvancedStyleClient | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
该类或扩展该类的类在 MXML 声明中使用时，调用 initialized 方法。 | AdvancedStyleClient | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
如果 cssState 与 currentCSSState 匹配，则返回 true。 | AdvancedStyleClient | |
|
确定此实例与给定类型相同，还是属于给定类型的子类。 | AdvancedStyleClient | |
|
将样式更改传播到此样式客户端实例的子项。 | AdvancedStyleClient | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
设置内部样式缓存值，以便 getStyle() 方法可以起作用。 | AdvancedStyleClient | |
|
将 EffectManager 注册为每个效果事件的事件侦听器之一。 | AdvancedStyleClient | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
|
设置循环操作动态属性的可用性。 | Object | |
|
对此组件实例设置样式属性。 | AdvancedStyleClient | |
|
检测对样式属性的更改。 | AdvancedStyleClient | |
|
首次初始化组件样式时，Flex 会调用 stylesInitialized() 方法。 | AdvancedStyleClient | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
根据语言约定将字符串转换为小写形式。 | StringTools | ||
|
返回指定对象的字符串表示形式。 | Object | |
根据语言约定将字符串转换为大写形式。 | StringTools | ||
|
返回指定对象的原始值。 | Object | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
属性详细信息
actualLocaleIDName | 属性 |
actualLocaleIDName:String [只读] [覆盖] | 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.5 |
由该类对象使用的实际区域设置 ID 的名称。这是用于从操作系统访问格式化数据和功能的区域设置。
如果由 locale 样式所设置的区域设置不可用，则 actualLocaleIDName 的值将不同于 locale 样式的值。它指明正在使用的回退区域设置。如果区域设置样式设置为 LocaleID.DEFAULT，将使用由用户的操作系统指定的区域设置的名称。
此属性可用作数据绑定的源。修改此属性后，将调度 change 事件。
实现
override public function get actualLocaleIDName():String相关 API 元素
flash.globalization.StringTools.actualLocaleIDName
StringTools()
StringTools()
lastOperationStatus | 属性 |
构造函数详细信息
StringTools | () | 构造函数 |
public function StringTools()| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 4.5 |
| 运行时版本: | Flash Player 10.1, AIR 2.5 |
构造新的 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 样式。
相关 API 元素
方法详细信息
getAvailableLocaleIDNames | () | 方法 |
toLowerCase | () | 方法 |
toUpperCase | () | 方法 |
示例 如何使用本示例
StringToolsExample.mxml
<?xml version="1.0" encoding="utf-8"?>
<!-- Sample program for spark.globalization.StringTools -->
<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:StringTools id="stringTools" />
</fx:Declarations>
<fx:Script>
<![CDATA[
import mx.collections.ArrayCollection;
private static const localeList:ArrayCollection
= new ArrayCollection([
{ label:"Turkish (tr)", data:"tr" },
{ label:"Greek (el)", data:"el" },
{ label:"German (de)", data:"de" },
{ label:"English (en)", data:"en" } ]);
private static const inputString:String =
"aá�æ� Iıİi (Turkish), σςΣΣ (Greek), SSß (German), bβв (Latin/Greek/Cyrillic)";
]]>
</fx:Script>
<mx:Form width="100%">
<mx:FormItem label="Select Language">
<mx:ComboBox id="localeSelector"
change="setStyle('locale', localeSelector.selectedItem.data);"
dataProvider="{localeList}"/>
</mx:FormItem>
<mx:FormItem label="Actual Locale ID Name">
<mx:Text text="{stringTools.actualLocaleIDName}"/>
</mx:FormItem>
<mx:FormItem width="100%" label="Upper Case Result">
<mx:Text width="100%"
text="{stringTools.toUpperCase(inputString)}"/>
</mx:FormItem>
<mx:FormItem width="100%" label="Lower Case Result">
<mx:Text width="100%"
text="{stringTools.toLowerCase(inputString)}"/>
</mx:FormItem>
</mx:Form>
</s:Application>
Tue Jun 12 2018, 11:04 AM Z