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.

Параметры

Возвращает массив строк, определяющих имена пакетов для всех объектов ResourceBundle, существующих в ResourceManager и принадлежащих указанному языковому стандарту.

В данном массиве порядок имен пакета не указан.

Параметры

Связанные элементы API

Получает значение указанного ресурса как Class.

Этот метод выполняет вызов getObject() и обеспечивает ввод класса с использованием оператора as. Результатом будет null, если значение ресурса не было ссылкой на класс. Это удобно, в случае если в файле свойств записаны, например, следующие строки

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

и необходимо получить класс, созданный директивой Embed() или ClassReference().

Если указанный ресурс не найден, этот метод возвращает null.

Параметры

Получает значение указанного ресурса как int.

Этот метод выполняет вызов getObject() и преобразует результат в int. Это удобно, если в файле свойств записана, например, следующая строка:

      MINIMUM=5
      

и необходимо получить значение 5, а не "5".

Если указанный ресурс не найден, этот метод возвращает 0.

Параметры

Возвращает массив строк, определяющих все языковые стандарты, для которых в ResourceManager существуют объекты ResourceBundle.

В данном массиве порядок языковых стандартов не указан.

Получает значение указанного ресурса как Number.

Этот метод выполняет вызов getObject() и преобразует результат в число. Это удобно, если в файле свойств записана, например, следующая строка:

      LONGITUDE=170.3
      

и необходимо получить значение 170,3, а не 170,3.

Если указанный ресурс не найден, этот метод возвращает NaN.

Параметры

Получает значение указанного ресурса как Object.

Значение возвращается без преобразования точно в таком же виде, в каком оно хранится в объекте content ResourceBundle. Если ресурс скомпилирован из файлов свойств, значение ресурса в объекте content всегда является строкой, если только не используется директива Embed() или ClassReference(). В этом случае значение ресурса всегда является классом. Для преобразования значений в более определенные типы используются методы getString(), getStringArray(), getNumber(), getInt() getUint(), getBoolean() и getClass().

Если указанный ресурс не найден, этот метод возвращает undefined.

Параметры

Возвращает массив строк, определяющих все языковые стандарты, для которых в ResourceManager существуют объекты ResourceBundle, и упорядоченных с использованием пользовательских установок, как изложено в Capabilities.language или Capabilities.languages.

Возвращает ResourceBundle с указанным locale и bundleName, который был ранее добавлен в ResourceManager с помощью addResourceBundle(). Если такой ResourceBundle не существует, этот метод возвращает null.

Параметры

Связанные элементы API

Получает значение указанного ресурса как String после замены указанных значений на метки-заполнители.

Этот метод выполняет вызов getObject(), а затем преобразует результат в строку.

Если в этот метод передается массив parameters, то параметры в нем преобразуются в строку и затем перед возвращением строки по порядку заменяются метками-заполнителями "\0\}", "\1\}" и так далее.

Если указанный ресурс не найден, этот метод возвращает null.

Параметры

Получает значение указанного ресурса как массив строк.

Этот метод предполагает, что значением ресурса является строка, содержащая список разделенных запятой элементов. Он выполняет вызов метода getString(), разделяет строку на элементы, разделенные запятыми, и сокращает пустое пространство перед каждым элементом и после него. Это удобно, если в файле свойств записана, например, следующая строка:

      COUNTRIES=India, China, Japan
      

и необходимо получить значение [ "India", "China", "Japan" ], а не значение "India, China, Japan".

Если указанный ресурс не найден, этот метод возвращает null.

Параметры

Получает значение указанного ресурса как uint.

Этот метод выполняет вызов getObject() и преобразует результат в uint. Это удобно, если в файле свойств записана, например, следующая строка:

      MINIMUM=5
      

и необходимо получить значение 5, а не "5".

Если указанный ресурс не найден, этот метод возвращает 0.

Параметры

Инициализирует свойство localeChain в ResourceManager с использованием алгоритма, который сравнивает список выбранных пользователем локалей, предоставленный операционной системой, со списком локалей, доступных в SWF.

Например, если в операционной системе пользователь выбрал французский язык и компиляция SWF выполнялась для локалей en_US, fr_FR, и de_DE, то в localeChain первой локалью в этом списке будет fr_FR.

Этот метод используется только классами, реализующими интерфейс IFlexModuleFactory.

Параметры

Связанные элементы API

Создает экземпляры всех подклассов ResourceBundle, которые были скомпилированы в SWF, и добавляет их в ResourceManager.

Например, если для параметра locales указано [ "en_US", "ja_JP" ] и для параметра bundleNames - [ "core", "controls" ], будет установлено четыре пакета ресурсов.

Этот метод используется только классами, реализующими интерфейс IFlexModuleFactory.

Параметры

Связанные элементы API

Начинает загружать модуль ресурса, содержащий пакеты ресурсов.

Каждый вызов этого метода возвращает новый объект передачи события, с помощью которого можно узнать, как выполняется загрузка, завершена ли она успешно или возникла ошибка. Этот объект передает события ResourceEvent.PROGRESS, ResourceEvent.COMPLETE и ResourceEvent.ERROR.

После загрузки модуля пакеты ресурсов добавляются в ResourceManager, но localeChain остается неизменным. Если параметр update имеет значение true, то будет выполнен вызов метода update().

Параметры

Связанные элементы API

Удаляет указанный ResourceBundle из ResourceManager, в результате чего будет невозможно получить доступ к его ресурсам с помощью методов ResourceManager, например getString().

Параметры

Связанные элементы API

Удаляет все ResourceBundle из ResourceManager, в результате чего будет невозможно получить доступ к их ресурсам с помощью методов ResourceManager, например getString().

Параметры

Связанные элементы API

Начинает выгрузку загруженного модуля ресурса.

После выгрузки модуля пакеты ресурсов удаляются из ResourceManager, однако localeChain остается неизменным. Если параметр update имеет значение true, то будет выполнен вызов метода update().

Параметры

Передает событие change из ResourceManager.

Этот метод заставляет выражения привязки выполнить повторный анализ того, задействуют ли они методы ResourceManager getObject(), getString(), getStringArray(), getNumber(), getInt(), getUint(), getBoolean() или getClass().

Этот метод также вызывает выполнение метода resourcesChanged() UIComponent, Formatter или Validator. Много компонентов реализуют этот метод для обновления их состояния на основе последних ресурсов.