LocaleID  - AS3

Состояние самой последней операции, выполненной этим объектом LocaleID. Свойство lastOperationStatus задается каждый раз при вызове конструктора или метода этого класса или при задании значения для другого свойства. Другие возможные значения см. в описании соответствующего метода.

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

Возвращает немного более «канонический» идентификатор локали.

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

• Для всех компонентов имени применяется надлежащий регистр.
• Символы подчеркивания меняются на тире.

Дополнительная обработка не выполняется. Например, псевдонимы не заменяются, элементы не добавляются и не удаляются.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Создает новый объект LocaleID с использованием имени локали. Имя локали должно соответствовать синтаксису, определенному в Техническом стандарте Юникод №35 (http://unicode.org/reports/tr35/).

Когда конструктор успешно создает объект, свойству lastOperationStatus задается значение:

• LastOperationStatus.NO_ERROR

Когда запрашиваемое имя идентификатора языкового стандарта недоступно, lastOperationStatus получает одно из следующих значений:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Дополнительные сведения о перечисленных выше предупреждениях и других возможных значениях свойства lastOperationStatus см. в описании класса LastOperationStatus.

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

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

Результирующий список сортируется в порядке предпочтения.

Ниже приводится пример типичного использования этого метода.

• Пользователь определяет список языков, которые он понимает (сохраненных в профиле пользователя, настройках браузера или файле cookie). Сначала пользователь указывает языки, которые он понимает лучше всего, поэтому порядок перечисления имеет большое значение. Это список пожеланий.
• Приложение локализовано для разных языков. Это список доступных языков.
• Метод determinePreferredLocales() возвращает совпадающие элементы из этих двух списков, перечисленные в порядке предпочтений пользователя.

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

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

Параметры

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

Возвращает объект, содержащий все пары клавиш и значений из объекта LocaleID.

Возвращенный объект имеет структуру хеш-таблицы или ассоциативного массива, где каждое имя свойства представляет клавишу, а значение этого свойства — значение для этой клавиши. Например, следующий код перечисляет все клавиши и значения, полученные из объекта LocaleID с помощью метода getKeysAndValues().

         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

Возвращает код языка, определенный в имени идентификатора локали.

Если имя локали не удается корректно проанализировать, то код языка совпадает с полным именем локали.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

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

Возвращает код региона, определенный в имени идентификатора локали.

Этот метод возвращает пустую строку, если код региона не удается выделить путем анализа или наугад. Такое случается, если используется неизвестное или неполное имя идентификатора локали, например «xy». Код региона не проверяется по фиксированному списку. Например, для имени идентификатора локали xx-YY возвращается код региона YY.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

Если регион не указывается в имени локали, «угадывается» наиболее вероятный код региона для локали, а свойству lastOperationStatus задается значение LastOperationStatus.USING_FALLBACK_WARNING

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

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

Возвращает код транскрипции, определенный в имени идентификатора локали.

Этот метод возвращает пустую строку, если код транскрипции не удается выделить путем анализа или наугад. Такое случается, если используется неизвестное или неполное имя идентификатора локали, например «xy». Код транскрипции не проверяется по фиксированному списку. Например, для имени идентификатора локали xx-Abcd-YY возвращается код транскрипции Abcd.

Область, а также язык, могут также влиять на возвращаемое значение. Например для идентификатора локали mn-MN (монгольский, Монголия) возвращается код транскрипции Cyrl (кириллица), а для mn-CN (монгольский, Китай) — Mong (монгольский).

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

Если код транскрипции не указывается в имени локали, «угадывается» наиболее вероятный код для локали, а свойству lastOperationStatus задается значение LastOperationStatus.USING_FALLBACK_WARNING.

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

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

Возвращает код варианта языка, определенный в имени идентификатора локали.

Этот метод возвращает пустую строку, если указанное имя идентификатора локали не содержит кода варианта языка. (Нет необходимости прибегать к угадыванию, так как лишь немногие локали имеют или требуют вариант языка.)

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

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

Указывает, что для указанной локали текст направлен справа налево.

Результат можно использовать для определения направления текста в механизме визуализации текста Flash, а также для определения того, следует ли использовать зеркальное отражение пользовательского интерфейса для обеспечения текущего направления текста.

Когда этот метод вызывается и успешно выполняется, свойство lastOperationStatus получает значение:

• LastOperationStatus.NO_ERROR

В противном случае в качестве значения свойства lastOperationStatus задается одна из констант, определенных в классе LastOperationStatus.

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

Указывает, что должны использоваться пользовательские настройки языка по умолчанию, заданные в операционной системе. Эти установки обычно задаются в окне «Панель управления» в ОС Windows или в окне «Системные настройки» в ОС Mac OS X.

Использование настройки LocaleID.DEFAULT может привести к использованию разных имен идентификатора локали для разных типов операций. Например, одна локаль может использоваться для сортировки, а другая для форматирования. Такая гибкость позволяет учитывать установки пользователя. Это нормальное поведение.

Данный идентификатор локали не во всех случаях является самым подходящим для применения. Для приложений, работающих в браузере, лучше использовать локаль, выбранную в установках браузера. Во многих случаях рекомендуется позволить пользователю изменять настройку предпочитаемого имени идентификатора локали и сохранить ее в профиле пользователя, файле 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);
            }
        }
    }
}