IResourceManager  - AS3 Flex

语言环境字符串（如 [ "en_US" ]）数组，指定要搜索资源的一个或多个语言环境。

通过调用 ResourceManager 方法 getObject()、getString()、getStringArray()、getNumber()、getInt()、getUint()、getBoolean() 或 getClass() 来获取资源值时，指定的是束名称和资源名称，而不是语言环境。ResourceManager 从 localeChain 中的第一个语言环境开始查找，查找该语言环境中具有指定束名称的 ResourceBundle。如果存在这样的 ResourceBundle 并且其中存在指定的资源，则会返回该资源的值。否则，ResourceManager 将继续查找 localeChain 中的其他语言环境。

通过此方案，可以使用不必包含完整一套本地化资源的语言环境。例如，如果要将应用程序本地化以便用于印第安英语而不是美国英语，只需要提供拼写或用法与美国英语不同的印第安英语的 en_IN 语言环境资源，然后将 localeChain 属性设置为 [ "en_IN", "en_US" ] 即可。

很多框架类都假定它们始终可从某些语言环境获取所需资源；如果无法获取，这些框架类将引发错误。因此，必须确保 localeChain 始终包含完整的一套资源。除非已完成所有框架资源和自己的应用程序资源的全部本地化，否则可以将 "en_US" 语言环境保留在 localeChain 的末尾来确保此要求得到满足。

设置此属性将导致 ResourceManager 调度 "change" 事件。

将指定的 ResourceBundle 添加到 ResourceManager，以便可通过 ResourceManager 方法（如 getString()）访问其资源。

参数

搜索 localeChain 中的语言环境以查找指定的资源，并返回所找到的第一个资源包。如果未找到该资源，则此方法将返回 null。

参数

获取指定资源的值作为 Boolean。

此方法首先调用 getString()并将结果转换为小写字符。然后，如果结果为 "true"，则返回 true；否则返回 false。

如果未找到指定的资源，则此方法将返回 false。

参数

返回一个字符串数组，指定所有位于 ResourceManager 中并且属于指定语言环境的 ResourceBundle 对象的束名称。

未指定该数组中的束名称顺序。

参数

相关 API 元素

获取指定资源的值作为 Class。

此方法调用 getObject() 并使用 as 运算符将其强制为 Class 类型。如果资源值不是类引用，则结果将为 null。如果已在属性文件中编写如下行：

      IMAGE=Embed("image.jpg")
      BUTTON_SKIN=ClassReference("skins.ButtonSkin_en_US")
      

并且想要获得 Embed() 或 ClassReference() 指令生成的类，则该方法很有用。

如果未找到指定的资源，则此方法将返回 null。

参数

获取指定资源的值作为 int。

此方法调用 getObject()并将结果转换为 int。如果已在属性文件中编写如下行：

      MINIMUM=5
      

并且想要获取值 5 而不是 "5"，则该方法很有用。

如果未找到指定的资源，则此方法将返回 0。

参数

返回一个字符串数组，指定 ResourceBundle 对象位于 ResourceManager 中的所有语言环境。

未指定该数组中的语言环境顺序。

获取指定资源的值作为 Number。

此方法调用 getObject()并将结果转换为数字。如果已在属性文件中编写如下行：

      LONGITUDE=170.3
      

并且想要获取值 170.3 而不是 "170.3"，则该方法很有用。

如果未找到指定的资源，则此方法将返回 NaN。

参数

获取指定资源的值作为 Object。

返回与 ResourceBundle 的 content 对象中存储的值完全相同的值，不经过任何转换。如果资源是从属性文件中编译的，则 content 对象中的资源值始终为字符串，除非使用 Embed() 或 ClassReference() 指令（在这种情况下资源值为类）。可使用 getString()、getStringArray()、getNumber()、getInt()、getUint()、getBoolean() 和 getClass() 方法将该值转换为更多特定类型。

如果未找到指定的资源，则此方法将返回 undefined。

参数

返回 String 的一个 Array，它指定在 ResourceManager 中存在 ResourceBundle 对象的所有语言环境，使用由 Capabilities.language 或 Capabilities.languages 报告的用户首选项进行排序。

返回之前使用 addResourceBundle() 添加到 ResourceManager 的具有指定 locale 和 bundleName 的 ResourceBundle。如果不存在这样的 ResourceBundle，则此方法返回 null。

参数

相关 API 元素

使用指定的值替换占位符之后，获取指定资源的值作为 String。

此方法调用 getObject()并将结果转换为字符串。

如果将 parameters 数组传递给此方法，则数组中包含的参数会转换成字符串，然后在返回前在字符串中按顺序替代占位符 "{0}"、"{1}" 等。

如果未找到指定的资源，则此方法将返回 null。

参数

获取指定资源的值作为 String 数组。

此方法假定资源值是包含用逗号分隔的项目列表的字符串。它将调用 getString() 方法，按逗号位置将字符串拆分成多项，并去掉每项前后的空格。如果已在属性文件中编写如下行：

      COUNTRIES=India, China, Japan
      

并且想要获取值 [ "India", "China", "Japan" ] 而不是值 "India, China, Japan"，则该方法很有用。

如果未找到指定的资源，则此方法将返回 null。

参数

获取指定资源的值作为 uint。

此方法调用 getObject() 方法并将结果转换为 uint。如果已在属性文件中编写如下行：

      MINIMUM=5
      

并且想要获取值 5 而不是 "5"，则该方法很有用。

如果未找到指定的资源，则此方法将返回 0。

参数

初始化 ResourceManager 的 localeChain 属性（使用将操作系统的用户首选区域设置列表与 SWF 中可用的区域设置列表进行比较的算法）。

例如，如果用户已指示其操作系统的首选语言是法语，而 SWF 针对 en_US、fr_FR 和 de_DE 区域设置进行编译的，则 localeChain 将设置为其首选区域设置为 fr_FR。

此方法仅由实现 IFlexModuleFactory 接口的类的使用。

参数

相关 API 元素

创建编辑到 SWF 的所有 ResourceBundle 子类的实例，并将它们添加到 ResourceManager 中。

例如，如果 locales 参数为 [ "en_US", "ja_JP" ]，bundleNames 参数为 [ "core", "controls" ]，将安装四个资源包。

此方法仅由实现 IFlexModuleFactory 接口的类的使用。

参数

相关 API 元素

开始加载包含资源包的资源模块。

每次调用此方法都会返回一个新的 event-dispatching 对象，可使用该对象了解加载的进度以及加载是成功完成还是产生了错误。该对象调度 ResourceEvent.PROGRESS、ResourceEvent.COMPLETE 和 ResourceEvent.ERROR 事件。

加载模块之后，资源包将添加到 ResourceManager，但 localeChain 保持不变。如果 update 参数为 true，将调用 update() 方法。

参数

相关 API 元素

从 ResourceManager 删除指定的 ResourceBundle，以便不再能通过 ResourceManager 方法（如 getString()）访问其资源。

参数

相关 API 元素

从 ResourceManager 删除指定的语言环境所对应的全部 ResourceBundle，以便不再能通过 ResourceManager 方法（如 getString()）访问其资源。

参数

相关 API 元素

开始卸载已加载的资源模块。

卸载模块后，其资源包会从 ResourceManager 中删除，但是 localeChain 会保持不变。如果 update 参数为 true，将调用 update() 方法。

参数

从 ResourceManager 调度 change 事件。

如果涉及 ResourceManager 方法 getObject()、getString()、getStringArray()、getNumber()、getInt()、getUint()、getBoolean() 或 getClass()，则会导致重新计算绑定的表达式。

该操作还会引起执行 UIComponent、Formatter 或 Validator 的 resourcesChanged() 方法。很多组件通过实现此方法来根据最新资源更新其状态。