LocaleID  - AS3

此 LocaleID 对象执行的最近操作的状态。只要调用构造函数或此类的方法或设置另一个属性，就会设置 lastOperationStatus 属性。有关可能的值，请参阅每种方法的说明。

相关 API 元素

返回一个略微更“规范”的区域设置标识符。

此方法对区域设置 ID 名称执行以下转换，使其采用更规范的形式。

• 对所有组件应用正确的大小写。
• 将下划线转换为的破折号。

不执行其他处理。例如，不替换别名、不添加或删除元素。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

使用给定的区域设置名称构造新的 LocaleID 对象。区域设置名称必须符合由 Unicode 技术标准 #35 ( http://unicode.org/reports/tr35/) 定义的语法。

成功完成构造函数后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

如果请求的区域设置 ID 名称不可用，则将 lastOperationStatus 属性设置为下列属性之一：

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的其中一个常量。

有关以上列出的警告和 lastOperationStatus 属性其他可能值的详细信息，请参阅 LastOperationStatus 类中的说明。

相关 API 元素

根据所需的区域设置列表以及现在可用的区域设置列表返回可接受的区域设置列表。

结果列表按首选项顺序排列。

下面是此方法的一个典型用例：

• 一个用户指定了他所会语言的列表（存储于用户配置文件、浏览器设置或者 Cookie 中）。用户按照自己对这些语言的掌握程度列出它们，因此列表中的语言顺序与此相对应。这是“期望”列表。
• 此应用程序将本地化为多种不同的语言。这是“具有”列表。
• determinePreferredLocales() 方法返回这两个列表的交集，以便最先显示用户的首选语言。

如果当前操作系统不支持此功能，此方法将返回 null 值。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

参数

相关 API 元素

返回一个对象，其中包含 LocaleID 对象中的所有键和值对。

返回对象被结构化为哈希表或关联数组，其中每个属性名表示一个键，而属性的值表示该键的值。例如，以下代码列出使用 getKeysAndValues() 方法从 LocaleID 对象获取的所有键和值：

         var myLocale:LocaleID = new LocaleID("fr-CA");
         var localeData:Object = myLocale.getKeysAndValues();
         for (var propertyName:String in localeData)
         {
           trace(propertyName + " = " + localeData[propertyName]);
         }
         

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

返回由区域设置 ID 名称指定的语言代码。

如果无法正确解析区域设置名称，则语言代码与完整的区域名称相同。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

返回区域设置 ID 名称指定的地区代码。

如果无法解析或推测地区代码，此方法将返回空字符串。如果使用了未知或类似“xy”这样不完整的区域设置 ID 名称，就可能出现此情况。未根据固定列表对地区代码进行验证。例如，为区域设置 ID 名称“xx-YY”返回的地区代码是“YY”。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

如果地区不是指定的区域设置名称的一部分，则会“推测”区域设置的最可能的地区代码，并将 lastOperationStatus 属性设置为 LastOperationStatus.USING_FALLBACK_WARNING

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

返回由区域设置 ID 名称指定的脚本代码。

如果无法解析或推测脚本代码，此方法将返回空字符串。如果使用了未知或类似“xy”这样不完整的区域设置 ID 名称，就可能出现此情况。未根据固定列表对脚本代码进行验证。例如，为区域设置 ID 名称“xx-Abcd-YY”返回的脚本代码是“Abcd”。

区域和语言也可以影响返回值。例如，“mn-MN”（蒙古语-蒙古）的脚本代码是“Cyrl”（西里尔文），而“mn-CN”（蒙古语-中国）的脚本代码是“Mong”（蒙古语）。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

如果脚本代码不是指定的区域名称的一部分，则会“推测”最可能的脚本代码，并将 lastOperationStatus 属性设置为 LastOperationStatus.USING_FALLBACK_WARNING。

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

返回由区域设置 ID 名称指定的语言变体代码。

如果给定的区域设置 ID 名称中不包含语言变体代码，则此方法将返回空字符串。（不需要推测，因为区域设置很少具有或需要语言变体。）

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

指定所指定的区域设置的文本方向是否为从右到左。

此结果可用于确定 Flash 文本引擎中的文本方向，以及用于决定是否应镜像用户界面以支持当前文本方向。

调用此方法并成功完成后，将 lastOperationStatus 属性设置为：

• LastOperationStatus.NO_ERROR

否则，将 lastOperationStatus 属性设置为 LastOperationStatus 类中定义的一个常量。

相关 API 元素

表示应使用的用户默认语言首选项，就像在用户操作系统设置上指定的那样。例如，对于 Windows，一般使用“控制面板”设置这些首选项，对于 Mac OS X，通常使用“系统首选项”设置这些首选项。

通过使用 LocaleID.DEFAULT 设置，可以为各种不同的操作使用不同的区域设置 ID 名称。例如，可以将一个区域设置用于排序，而将另一个区域设置用于格式设置。这种灵活性与用户首选项相关，根据设计，此类的行为遵守此方式。

此区域设置标识符不总是最适合使用的那一个。对于在浏览器中运行的应用程序，浏览器的首选区域设置是更好的选择。告知用户更改首选区域设置 ID 名称设置并将首选项保留在用户配置文件、Cookie 或共享对象中，通常是一种很好的做法。

此示例使用以下区域设置：阿拉伯语(沙特阿拉伯)、英语（美国）、英语（美国、POSIX 变体）、中文（中国）、中文（台湾）、中文（简化汉字脚本）和中文（中国，具有多个键和值）

此示例为该列表中的每个区域设置执行下列操作：

1. 新建 LocaleID 对象。
2. 显示 LocaleID 的各种属性。显示的值将因操作系统和用户首选项不同而异。
3. 显示该 LocaleID 的键和值的完整集合。

package 
{
    import flash.display.Sprite;
    import flash.globalization.LocaleID;
    
    public class LocaleIDExample extends Sprite
    {
        public function LocaleIDExample()
        {
            var localeNames:Array = ["ar-SA", "EN_us", "en-US-POSIX", "zh-CH", "zh-TW", "zh-Hans", "zh-CH@collation=pinyin;calendar=chinese;currency=RMB"];
            
            for ( var i:int = 0; i < localeNames.length; i++ ) 
            {
                var locID:LocaleID = new LocaleID( localeNames[i] as String );
                
                trace('\n\n' + "LocaleID requested: " + locID.requestedLocaleIDName 
                    + "; actual: " + locID.actualLocaleIDName);
                trace( "Last Operation Status after new LocaleID: " + locID.lastOperationStatus);
                
                trace("name:     " + locID.name);
                trace("language: " + locID.getLanguage() + "; status: "  + locID.lastOperationStatus);
                trace("script:   " + locID.getScript()  +  "; status: "  + locID.lastOperationStatus);
                trace("region:   " + locID.getRegion()  +  "; status: "  + locID.lastOperationStatus);
                trace("variant:  " + locID.getVariant()  + "; status: "  + locID.lastOperationStatus);
                trace("isRightToLeft: ", locID.isRightToLeft(), "; status: "  + locID.lastOperationStatus);
                
                var keysAndValues:Object = locID.getKeysAndValues();
                var key:String;
                for (key in keysAndValues)
                {
                    trace("key: ", key + " value: " + keysAndValues[ key ]);
                }
                trace( "Last Operation Status after getKeysAndValues(): " + locID.lastOperationStatus);
            }
        }
    }
}