Пакет | mx.resources |
Интерфейс | public interface IResourceManager extends IEventDispatcher |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
В локализации используется три основных понятия: языковые стандарты, ресурсы и пакеты ресурсов.
Языковой стандарт указывает язык и страну, для которой было локализовано приложение. Например, языковой стандарт en_US
указывает английский язык в качестве разговорного в США. (Для получения дополнительной информации см. класс mx.resources.Locale.)
Ресурс – это именованное значение, зависящее от языкового стандарта. Например, приложение имеет ресурс с именем OPEN
. Значение ресурса для английского языкового стандарта – Open
, а для французского языкового стандарта это значение – Ouvrir
.
Пакет ресурсов – это именованная группа ресурсов, значения которых были локализованы для определенного языкового стандарта. Пакет ресурсов определяется комбинацией bundleName
и locale
, а также имеет объект content
, содержащий пары «имя - значение» для ресурсов пакета. Для получения информации о создании пакетов ресурсов из файлов свойств см. документацию для mx.resources.IResourceBundle.
Одиночный объект ResourceManager, реализующий интерфейс IResourceManager, управляет несколькими пакетами ресурсов, в том числе для нескольких языковых стандартов, и предоставляет доступ к содержащимся в них ресурсам. Например, можно извлечь определенный ресурс как строку путем вызова resourceManager.getString(bundleName, resourceName)
.
Все классы, являющиеся расширениями UIComponent, Formatter или Validator, имеют свойство resourceManager
, которое предоставляет ссылку на объект, реализующий этот интерфейс. Другие классы могут выполнять вызов ResourceManager.getInstance()
для получения этого объекта.
Методы поиска ресурсов (например, getString()
) выполняют поиск ресурсов в языковых стандартах, указанных свойством localeChain
. Путем изменения этого свойства можно указать для приложения использование, например японских, а не английских ресурсов.
При запуске приложения ResourceManager автоматически заполняется любыми пакетами ресурсов, которые были скомпилированы в приложение. По умолчанию при создании модуля кода ресурсы, необходимые для его классов, компилируются в модуль. При загрузке модуля в приложение любые пакеты, которых еще нет в приложении, добавляются в ResourceManager.
Можно скомпилировать «модули ресурсов», содержащие только ресурсы, и загрузить их с помощью метода loadResourceModule()
интерфейса IResourceManager. С помощью модулей ресурсов можно обеспечить поддержку несколько языковых стандартов путем загрузки необходимых ресурсов во время выполнения вместо компиляции их в приложение.
Несмотря на то что обычно ResourceManager заполняется пакетами ресурсов, которые были скомпилированы в приложение или загружены из модулей, пакеты ресурсов можно также создавать программным путем и самостоятельно добавлять их к ResourceManager при помощи метода addResourceBundle()
.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
localeChain : Array
Массив строк языковых стандартов, таких как [ "en_US" ], указывающий один или более языковых стандартов, в которых будет выполняться поиск ресурсов. | IResourceManager |
Метод | Определено | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | IEventDispatcher | ||
Добавляет указанный ResourceBundle в ResourceManager для обеспечения доступа к его ресурсам с помощью методов ResourceManager, например getString(). | IResourceManager | ||
Посылает событие в поток событий. | IEventDispatcher | ||
Выполняет поиск указанного ресурса в языковых стандартах в localeChain и возвращает первый пакет ресурсов, в котором он найден. | IResourceManager | ||
Получает значение указанного ресурса как Boolean. | IResourceManager | ||
Возвращает массив строк, определяющих имена пакетов для всех объектов ResourceBundle, существующих в ResourceManager и принадлежащих указанному языковому стандарту. | IResourceManager | ||
Получает значение указанного ресурса как Class. | IResourceManager | ||
Получает значение указанного ресурса как int. | IResourceManager | ||
Возвращает массив строк, определяющих все языковые стандарты, для которых в ResourceManager существуют объекты ResourceBundle. | IResourceManager | ||
Получает значение указанного ресурса как Number. | IResourceManager | ||
Получает значение указанного ресурса как Object. | IResourceManager | ||
Возвращает массив строк, определяющих все языковые стандарты, для которых в ResourceManager существуют объекты ResourceBundle, и упорядоченных с использованием пользовательских установок, как изложено в Capabilities.language или Capabilities.languages. | IResourceManager | ||
Возвращает ResourceBundle с указанным языковым стандартом и bundleName, который был ранее добавлен в ResourceManager с помощью addResourceBundle(). | IResourceManager | ||
getString(bundleName:String, resourceName:String, parameters:Array = null, locale:String = null):String
Получает значение указанного ресурса как String после замены указанных значений на метки-заполнители. | IResourceManager | ||
Получает значение указанного ресурса как массив строк. | IResourceManager | ||
Получает значение указанного ресурса как uint. | IResourceManager | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | IEventDispatcher | ||
Инициализирует свойство localeChain в ResourceManager с использованием алгоритма, который сравнивает список выбранных пользователем локалей, предоставленный операционной системой, со списком локалей, доступных в SWF. | IResourceManager | ||
installCompiledResourceBundles(applicationDomain:ApplicationDomain, locales:Array, bundleNames:Array, useWeakReference:Boolean = false):Array
Создает экземпляры всех подклассов ResourceBundle, которые были скомпилированы в SWF, и добавляет их в ResourceManager. | IResourceManager | ||
loadResourceModule(url:String, update:Boolean = true, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
Начинает загружать модуль ресурса, содержащий пакеты ресурсов. | IResourceManager | ||
Удаляет прослушиватель из объекта EventDispatcher. | IEventDispatcher | ||
Удаляет указанный ResourceBundle из ResourceManager, в результате чего будет невозможно получить доступ к его ресурсам с помощью методов ResourceManager, например getString(). | IResourceManager | ||
Удаляет все ResourceBundle из ResourceManager, в результате чего будет невозможно получить доступ к их ресурсам с помощью методов ResourceManager, например getString(). | IResourceManager | ||
Начинает выгрузку загруженного модуля ресурса. | IResourceManager | ||
Передает событие change из ResourceManager. | IResourceManager | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | IEventDispatcher |
localeChain | свойство |
localeChain:Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Массив строк языковых стандартов, таких как [ "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
.
Реализация
public function get localeChain():Array
public function set localeChain(value:Array):void
addResourceBundle | () | метод |
public function addResourceBundle(resourceBundle:IResourceBundle, useWeakReference:Boolean = false):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Добавляет указанный ResourceBundle в ResourceManager для обеспечения доступа к его ресурсам с помощью методов ResourceManager, например getString()
.
Параметры
resourceBundle:IResourceBundle — Добавляемый пакет ресурсов.
| |
useWeakReference:Boolean (default = false ) — Определяет, содержит ли ResourceManager слабую ссылку к пакету ресурсов. Если useWeakReference имеет значение true , то ResourceManager предоставит слабую ссылку на пакет ресурсов. Когда вызывающий модуль использует слабую ссылку, то обязанностью этого модуля является сохранение жесткой ссылки на пакет ресурсов, чтобы он не был преждевременно удален во время сборки мусора. Если useWeakReference имеет значение false , то ResourceManager сохраняет жесткую ссылку на пакет ресурсов, который, таким образом, не будет задействован во время сборки мусора.
Когда подчиненное приложение или модуль Flex автоматически добавляет свои откомпилированные пакеты ресурсов в ResourceManager, вызывается |
findResourceBundleWithResource | () | метод |
public function findResourceBundleWithResource(bundleName:String, resourceName:String):IResourceBundle
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Выполняет поиск указанного ресурса в языковых стандартах в localeChain
и возвращает первый пакет ресурсов, в котором он найден. Если ресурс не найден, этот метод возвращает null
.
Параметры
bundleName:String — Имя пакета, например MyResources .
| |
resourceName:String — Имя ресурса в пакете ресурсов.
|
IResourceBundle — Первый ResourceBundle в localeChain , который содержит указанный ресурс, или null .
|
getBoolean | () | метод |
public function getBoolean(bundleName:String, resourceName:String, locale:String = null):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает значение указанного ресурса как Boolean.
Этот метод сначала выполняет вызов getString()
и преобразовывает результат в нижний регистр. А затем возвращает true
, если результат был true
. и false
в противном случае.
Если указанный ресурс не найден, этот метод возвращает false
.
Параметры
bundleName:String — Имя пакета ресурсов.
| |
resourceName:String — Имя ресурса в пакете ресурсов.
| |
locale:String (default = null ) — Определенный языковой стандарт, используемый для поиска, или null для выполнения поиска во всех языковых стандартах в localeChain . Этот параметр является необязательным и по умолчанию его значение null ; как правило, изменять данный параметр не требуется.
|
Boolean — Логическое значение для ресурса или false , если ресурс не найден.
|
getBundleNamesForLocale | () | метод |
public function getBundleNamesForLocale(locale:String):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает массив строк, определяющих имена пакетов для всех объектов ResourceBundle, существующих в ResourceManager и принадлежащих указанному языковому стандарту.
В данном массиве порядок имен пакета не указан.
Параметры
locale:String — Строка языкового стандарта, например en_US .
|
Array — Массив имен пакета.
|
Связанные элементы API
getClass | () | метод |
public function getClass(bundleName:String, resourceName:String, locale:String = null):Class
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает значение указанного ресурса как Class.
Этот метод выполняет вызов getObject()
и обеспечивает ввод класса с использованием оператора as
. Результатом будет null
, если значение ресурса не было ссылкой на класс. Это удобно, в случае если в файле свойств записаны, например, следующие строки
IMAGE=Embed("image.jpg") BUTTON_SKIN=ClassReference("skins.ButtonSkin_en_US")
и необходимо получить класс, созданный директивой Embed()
или ClassReference()
.
Если указанный ресурс не найден, этот метод возвращает null
.
Параметры
bundleName:String — Имя пакета ресурсов.
| |
resourceName:String — Имя ресурса в пакете ресурсов.
| |
locale:String (default = null ) — Определенный языковой стандарт, используемый для поиска, или null для выполнения поиска во всех языковых стандартах в localeChain . Этот параметр является необязательным и по умолчанию его значение null ; как правило, изменять данный параметр не требуется.
|
Class — Значение ресурса как Class или null , если ресурс не найден.
|
getInt | () | метод |
public function getInt(bundleName:String, resourceName:String, locale:String = null):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает значение указанного ресурса как int.
Этот метод выполняет вызов getObject()
и преобразует результат в int. Это удобно, если в файле свойств записана, например, следующая строка:
MINIMUM=5
и необходимо получить значение 5, а не "5"
.
Если указанный ресурс не найден, этот метод возвращает 0.
Параметры
bundleName:String — Имя пакета ресурсов.
| |
resourceName:String — Имя ресурса в пакете ресурсов.
| |
locale:String (default = null ) — Определенный языковой стандарт, используемый для поиска, или null для выполнения поиска во всех языковых стандартах в localeChain . Этот параметр является необязательным и по умолчанию его значение null ; как правило, изменять данный параметр не требуется.
|
int — Значение ресурса как int или 0, если ресурс не найден.
|
getLocales | () | метод |
public function getLocales():Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает массив строк, определяющих все языковые стандарты, для которых в ResourceManager существуют объекты ResourceBundle.
В данном массиве порядок языковых стандартов не указан.
ВозвращаетArray — Массив строк языковых стандартов.
|
getNumber | () | метод |
public function getNumber(bundleName:String, resourceName:String, locale:String = null):Number
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает значение указанного ресурса как Number.
Этот метод выполняет вызов getObject()
и преобразует результат в число. Это удобно, если в файле свойств записана, например, следующая строка:
LONGITUDE=170.3
и необходимо получить значение 170,3, а не 170,3
.
Если указанный ресурс не найден, этот метод возвращает NaN
.
Параметры
bundleName:String — Имя пакета ресурсов.
| |
resourceName:String — Имя ресурса в пакете ресурсов.
| |
locale:String (default = null ) — Определенный языковой стандарт, используемый для поиска, или null для выполнения поиска во всех языковых стандартах в localeChain . Этот параметр является необязательным и по умолчанию его значение null ; как правило, изменять данный параметр не требуется.
|
Number — Значение ресурса в виде числа или NaN , если ресурс не найден.
|
getObject | () | метод |
public function getObject(bundleName:String, resourceName:String, locale:String = null):*
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает значение указанного ресурса как Object.
Значение возвращается без преобразования точно в таком же виде, в каком оно хранится в объекте content
ResourceBundle. Если ресурс скомпилирован из файлов свойств, значение ресурса в объекте content
всегда является строкой, если только не используется директива Embed()
или ClassReference()
. В этом случае значение ресурса всегда является классом. Для преобразования значений в более определенные типы используются методы getString()
, getStringArray()
, getNumber()
, getInt()
getUint()
, getBoolean()
и getClass()
.
Если указанный ресурс не найден, этот метод возвращает undefined
.
Параметры
bundleName:String — Имя пакета ресурсов.
| |
resourceName:String — Имя ресурса в пакете ресурсов.
| |
locale:String (default = null ) — Определенный языковой стандарт, используемый для поиска, или null для выполнения поиска во всех языковых стандартах в localeChain . Этот параметр является необязательным и по умолчанию его значение null ; как правило, изменять данный параметр не требуется.
|
* — Значение ресурса точно в таком же виде, в каком оно хранится в объекте content , или undefined , если ресурс не найден.
|
getPreferredLocaleChain | () | метод |
public function getPreferredLocaleChain():Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает массив строк, определяющих все языковые стандарты, для которых в ResourceManager существуют объекты ResourceBundle, и упорядоченных с использованием пользовательских установок, как изложено в Capabilities.language
или Capabilities.languages
.
Array — Массив строк языковых стандартов.
|
getResourceBundle | () | метод |
public function getResourceBundle(locale:String, bundleName:String):IResourceBundle
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает ResourceBundle с указанным locale
и bundleName
, который был ранее добавлен в ResourceManager с помощью addResourceBundle()
. Если такой ResourceBundle не существует, этот метод возвращает null
.
Параметры
locale:String — Строка языкового стандарта, например en_US .
| |
bundleName:String — Имя пакета, например MyResources .
|
IResourceBundle — ResourceBundle с указанным locale и bundleName , если таковой существует; в противном случае null .
|
Связанные элементы API
getString | () | метод |
public function getString(bundleName:String, resourceName:String, parameters:Array = null, locale:String = null):String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает значение указанного ресурса как String после замены указанных значений на метки-заполнители.
Этот метод выполняет вызов getObject()
, а затем преобразует результат в строку.
Если в этот метод передается массив parameters
, то параметры в нем преобразуются в строку и затем перед возвращением строки по порядку заменяются метками-заполнителями "\0\}"
, "\1\}"
и так далее.
Если указанный ресурс не найден, этот метод возвращает null
.
Параметры
bundleName:String — Имя пакета ресурсов.
| |
resourceName:String — Имя ресурса в пакете ресурсов.
| |
parameters:Array (default = null ) — Массив параметров, замененных метками-заполнителями. Перед заменой каждый параметр преобразуется в строку с помощью метода toString() .
| |
locale:String (default = null ) — Определенный языковой стандарт, используемый для поиска, или null для выполнения поиска во всех языковых стандартах в localeChain . Этот параметр является необязательным и по умолчанию его значение null ; как правило, изменять данный параметр не требуется.
|
String — Значение ресурса в виде строки или null , если ресурс не найден.
|
getStringArray | () | метод |
public function getStringArray(bundleName:String, resourceName:String, locale:String = null):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает значение указанного ресурса как массив строк.
Этот метод предполагает, что значением ресурса является строка, содержащая список разделенных запятой элементов. Он выполняет вызов метода getString()
, разделяет строку на элементы, разделенные запятыми, и сокращает пустое пространство перед каждым элементом и после него. Это удобно, если в файле свойств записана, например, следующая строка:
COUNTRIES=India, China, Japan
и необходимо получить значение [ "India", "China", "Japan" ]
, а не значение "India, China, Japan"
.
Если указанный ресурс не найден, этот метод возвращает null
.
Параметры
bundleName:String — Имя пакета ресурсов.
| |
resourceName:String — Имя ресурса в пакете ресурсов.
| |
locale:String (default = null ) — Определенный языковой стандарт, используемый для поиска, или null для выполнения поиска во всех языковых стандартах в localeChain . Этот параметр является необязательным и по умолчанию его значение null ; как правило, изменять данный параметр не требуется.
|
Array — Значение ресурса как массив строк или null , если ресурс не найден.
|
getUint | () | метод |
public function getUint(bundleName:String, resourceName:String, locale:String = null):uint
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Получает значение указанного ресурса как uint.
Этот метод выполняет вызов getObject()
и преобразует результат в uint. Это удобно, если в файле свойств записана, например, следующая строка:
MINIMUM=5
и необходимо получить значение 5, а не "5"
.
Если указанный ресурс не найден, этот метод возвращает 0.
Параметры
bundleName:String — Имя пакета ресурсов.
| |
resourceName:String — Имя ресурса в пакете ресурсов.
| |
locale:String (default = null ) — Определенный языковой стандарт, используемый для поиска, или null для выполнения поиска во всех языковых стандартах в localeChain . Этот параметр является необязательным и по умолчанию его значение null ; как правило, изменять данный параметр не требуется.
|
uint — Значение ресурса как uint или 0, если ресурс не найден.
|
initializeLocaleChain | () | метод |
public function initializeLocaleChain(compiledLocales:Array):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Инициализирует свойство localeChain
в ResourceManager с использованием алгоритма, который сравнивает список выбранных пользователем локалей, предоставленный операционной системой, со списком локалей, доступных в SWF.
Например, если в операционной системе пользователь выбрал французский язык и компиляция SWF выполнялась для локалей en_US, fr_FR, и de_DE, то в localeChain
первой локалью в этом списке будет fr_FR.
Этот метод используется только классами, реализующими интерфейс IFlexModuleFactory.
Параметры
compiledLocales:Array — Массив строк, определяющих локали, для которых выполнялась компиляция SWF.
|
Связанные элементы API
installCompiledResourceBundles | () | метод |
public function installCompiledResourceBundles(applicationDomain:ApplicationDomain, locales:Array, bundleNames:Array, useWeakReference:Boolean = false):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Создает экземпляры всех подклассов ResourceBundle, которые были скомпилированы в SWF, и добавляет их в ResourceManager.
Например, если для параметра locales
указано [ "en_US", "ja_JP" ] и для параметра bundleNames
- [ "core", "controls" ], будет установлено четыре пакета ресурсов.
Этот метод используется только классами, реализующими интерфейс IFlexModuleFactory.
Параметры
applicationDomain:ApplicationDomain — ApplicationDomain, используемый для поиска классов пакета ресурсов по имени.
| |
locales:Array — Массив строк, определяющих локали, для которых выполнялась компиляция SWF.
| |
bundleNames:Array — Массив строк, определяющих имена пакетов ресурсов, которые были скомпилированы в SWF.
| |
useWeakReference:Boolean (default = false ) — Флаг, который указывает, необходимо ли установить пакеты ресурсов в ResourceManager с использованием слабой ссылки.
|
Array — Массив экземпляров ResourceBundle, которые были созданы и добавлены в ResourceManager.
|
Связанные элементы API
loadResourceModule | () | метод |
public function loadResourceModule(url:String, update:Boolean = true, applicationDomain:ApplicationDomain = null, securityDomain:SecurityDomain = null):IEventDispatcher
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Начинает загружать модуль ресурса, содержащий пакеты ресурсов.
Каждый вызов этого метода возвращает новый объект передачи события, с помощью которого можно узнать, как выполняется загрузка, завершена ли она успешно или возникла ошибка. Этот объект передает события ResourceEvent.PROGRESS
, ResourceEvent.COMPLETE
и ResourceEvent.ERROR
.
После загрузки модуля пакеты ресурсов добавляются в ResourceManager, но localeChain
остается неизменным. Если параметр update
имеет значение true
, то будет выполнен вызов метода update()
.
Параметры
url:String — URL-адрес, с которого загружается модуль ресурса.
| |
update:Boolean (default = true ) — Выполнять ли вызов метода update() после завершения загрузки модуля.
| |
applicationDomain:ApplicationDomain (default = null ) — ApplicationDomain передается в метод load() класса IModuleInfo, загружающий модуль ресурса. Это дополнительный параметр и по умолчанию его значение null .
| |
securityDomain:SecurityDomain (default = null ) — SecurityDomain передается в метод load() класса IModuleInfo, загружающий модуль ресурса. Это дополнительный параметр и по умолчанию его значение null .
|
IEventDispatcher — Объект, связанный с этой конкретной операцией загрузки, передающей события ResourceEvent.PROGRESS , ResourceEvent.COMPLETE и ResourceEvent.ERROR .
|
Связанные элементы API
removeResourceBundle | () | метод |
public function removeResourceBundle(locale:String, bundleName:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет указанный ResourceBundle из ResourceManager, в результате чего будет невозможно получить доступ к его ресурсам с помощью методов ResourceManager, например getString()
.
Параметры
locale:String — Строка языкового стандарта, например en_US .
| |
bundleName:String — Имя пакета, например MyResources .
|
Связанные элементы API
removeResourceBundlesForLocale | () | метод |
public function removeResourceBundlesForLocale(locale:String):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Удаляет все ResourceBundle из ResourceManager, в результате чего будет невозможно получить доступ к их ресурсам с помощью методов ResourceManager, например getString()
.
Параметры
locale:String — Строка языкового стандарта, например en_US .
|
Связанные элементы API
unloadResourceModule | () | метод |
public function unloadResourceModule(url:String, update:Boolean = true):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Начинает выгрузку загруженного модуля ресурса.
После выгрузки модуля пакеты ресурсов удаляются из ResourceManager, однако localeChain
остается неизменным. Если параметр update
имеет значение true
, то будет выполнен вызов метода update()
.
Параметры
url:String — URL-адрес, использованный для загрузки модуля ресурса.
| |
update:Boolean (default = true ) — Определяет необходимость вызова метода update() после завершения выгрузки модуля.
|
update | () | метод |
public function update():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Передает событие change
из ResourceManager.
Этот метод заставляет выражения привязки выполнить повторный анализ того, задействуют ли они методы ResourceManager getObject()
, getString()
, getStringArray()
, getNumber()
, getInt()
, getUint()
, getBoolean()
или getClass()
.
Этот метод также вызывает выполнение метода resourcesChanged()
UIComponent, Formatter или Validator. Много компонентов реализуют этот метод для обновления их состояния на основе последних ресурсов.
Tue Jun 12 2018, 11:34 AM Z