LocaleID  - AS3

Status ostatniej operacji wykonanej przez ten obiekt LocaleID. Właściwość lastOperationStatus zostanie ustawiona przy każdym wywołaniu konstruktora lub metody tej klasy, a także w przypadku ustawienia innej właściwości. Możliwe wartości przedstawiają opisy poszczególnych metod.

Powiązane elementy interfejsu API

Zwraca nieznacznie bardziej kanoniczny identyfikator ustawień regionalnych.

Ta metoda dokonuje następującego przekształcenia na nazwę identyfikatora ustawienia narodowego w celu zapewnienia bardziej kanonicznej formy.

• We wszystkich składnikach stosowane są litery odpowiedniej wielkości.
• Znaki podkreślenia są przekształcane na myślniki.

Nie są wykonywane żadne inne operacje przetwarzania. Na przykład: aliasy nie są zastępowane i żadne inne elementy nie są dodawane ani usuwane.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Tworzy nowy obiekt LocaleID, któremu nadano nazwę ustawienia narodowego. Nazwa ustawienia narodowego musi być zgodna ze składnią zdefiniowaną przez standard techniczny Unicode nr 35 (http://unicode.org/reports/tr35/).

Jeśli działanie konstruktora zostanie pomyślnie zakończone, wówczas właściwość lastOperationStatus jest ustawiana na:

• LastOperationStatus.NO_ERROR

Jeśli identyfikator żądanych ustawień narodowych nie jest dostępny, wówczas właściwość lastOperationStatus zostanie ustawiona na jedną z poniższych wartości:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Szczegółowe informacje na temat ostrzeżeń przedstawionych powyżej oraz na temat innych możliwych wartości właściwości lastOperationStatus zawierają opisy w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Zwraca listę akceptowalnych ustawień regionalnych zgodnie z listą żądanych ustawień regionalnych oraz listą ustawień regionalnych, jakie są aktualnie dostępne.

Lista wynikowa jest posortowana zgodnie z kolejnością preferencji.

Oto typowy przykład użycia tej metody:

• Użytkownik określa listę języków, które rozumie (zapisana w profilu użytkownika, w ustawieniach przeglądarki lub w pliku cookie). Jako pierwsze na liście języków użytkownik umieszcza te języki, które rozumie najlepiej, dlatego kolejność na liście jest istotna. Jest to lista wartości „żądanych”.
• Zlokalizowana aplikacja udostępnia różne języki. Jest to lista wartości „rzeczywistych”.
• Metoda determinePreferredLocales() zwraca część wspólną tych dwóch list, posortowaną w taki sposób, że języki preferowane przez użytkownika są prezentowane na liście jako pierwsze.

Jeśli ta funkcja nie jest obsługiwana w bieżącym systemie operacyjnym, wówczas ta metoda zwróci wartość null.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Parametry

Powiązane elementy interfejsu API

Zwraca obiekt zawierający wszystkie pary kluczy i wartości z obiektu LocaleID.

Zwracany obiekt ma strukturę tabeli mieszającej lub tablicy asocjacyjnej, w którym nazwa każdej właściwości reprezentuje klucz, a wartość właściwości jest wartością dla tego klucza. Na przykład: poniższy kod zawiera listę wszystkich kluczy i wartości uzyskiwanych z obiektu LocaleID za pomocą metody getKeysAndValues():

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

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Zwraca kod języka określony przez identyfikator ustawienia narodowego.

Jeśli nazwa ustawienia narodowego nie może zostać poprawnie przeanalizowana, wówczas kod języka będzie taki sam, jak pełna nazwa ustawienia narodowego.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Zwraca kod regionu określony przez identyfikator ustawienia regionalnego.

Ta metoda zwraca pusty ciąg znaków, jeśli nie można uzyskać kodu regionu na drodze analizy ani nie można go odgadnąć. Do tego może dojść, jeśli używany jest nieznany lub niekompletny identyfikator ustawienia narodowego, taki jak „xy”. Poprawność kodu regionu nie jest sprawdzana na liście ustalonych wartości. Na przykład: kod regionu zwrócony dla ustawienia narodowego o identyfikatorze „xx-YY” będzie „YY”.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

Jeśli region nie jest częścią nazwy określonego ustawienia narodowego, wówczas najbardziej prawdopodobne jest to, że kod regionu dla ustawienia narodowego zostanie „odgadnięty”, a dla właściwości lastOperationStatus zostanie ustawiona wartość LastOperationStatus.USING_FALLBACK_WARNING

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Zwraca kod skryptu określony przez identyfikator ustawienia narodowego.

Ta metoda zwraca pusty ciąg znaków, jeśli nie można uzyskać kodu skryptu na drodze analizy ani nie można go odgadnąć. Do tego może dojść, jeśli używany jest nieznany lub niekompletny identyfikator ustawienia narodowego, taki jak „xy”. Poprawność kodu skryptu nie jest sprawdzana na liście ustalonych wartości. Na przykład: kod skryptu zwrócony dla ustawienia narodowego o identyfikatorze „xx-Abcd-YY” będzie „Abcd”.

Region oraz język mogą również wpływać na zwracaną wartość. Na przykład: kod skryptu dla „mn-MN” (mongolski-Mongolia) będzie równy „Cyrl” (cyrylica), a kod skryptu dla „mn-CN” (mongolski-Chiny) będzie równy „Mong” (mongolski).

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

Jeśli kod skryptu nie jest częścią nazwy określonego ustawienia narodowego, wówczas najbardziej prawdopodobne jest to, że kod skryptu dla ustawienia narodowego zostanie „odgadnięty”, a dla właściwości lastOperationStatus zostanie ustawiona wartość LastOperationStatus.USING_FALLBACK_WARNING

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Zwraca kod wariantu języka określony przez identyfikator ustawienia regionalnego.

Ta metoda zwraca pusty ciąg znaków, jeśli określony identyfikator ustawienia narodowego nie zawiera kodu wariantu języka. (Nie jest wymagane odgadywanie, ponieważ niewiele ustawień narodowych zawiera i wymaga wariantu języka).

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Określa, czy kierunek tekstu dla określonych ustawień narodowych to kierunek od prawej do lewej.

Wynik można wykorzystać w celu określenia kierunku tekstu w mechanizmie tekstu Flash, a także w celu określenia, czy powinna zostać utworzona kopia lustrzana interfejsu użytkownika w celu obsługiwania bieżącego kierunku tekstu.

Jeśli działanie wywołanej metody zakończy się pomyślnie, wówczas właściwość lastOperationStatus zostanie ustawiona na:

• LastOperationStatus.NO_ERROR

W przeciwnym wypadku właściwość lastOperationStatus zostanie ustawiona na jedną ze stałych zdefiniowanych w klasie LastOperationStatus.

Powiązane elementy interfejsu API

Wskazuje, że powinny być używane domyślne preferencje językowe użytkownika, określone w ustawieniach systemu operacyjnego. Na przykład: takie preferencje są zwykle ustawiane za pomocą panelu sterowania w systemie Windows lub preferencji systemu w systemie Mac OS X.

Korzystanie z ustawienia LocaleID.DEFAULT może spowodować użycie innego identyfikatora ustawień narodowych dla różnych rodzajów operacji. Na przykład: jedno ustawienie narodowe może być używane do sortowania, a inne do formatowania. Ta elastyczność uwzględnia preferencje użytkownika, a klasa jest zgodna z zaprojektowanymi ustawieniami.

Ustawienie narodowe o określonym identyfikatorze nie zawsze jest ustawieniem najbardziej odpowiednim do użytku. W przypadku aplikacji działających w przeglądarce lepsze mogą się okazać ustawienia narodowe preferowane przez przeglądarkę. Często dobrym rozwiązaniem jest zezwolenie użytkownikowi na zmodyfikowanie identyfikatora preferowanych ustawień narodowych i zachowanie tych preferencji w profilu użytkownika, pliku cookie lub w obiekcie udostępnionym.

W tym przykładzie wykorzystano następujące ustawienia narodowe: arabski (Arabia Saudyjska), angielski (USA), angielski (USA, wariant POSIX), chiński (Ch.R.L.), chiński (Tajwan), chiński (uproszczony skrypt Han), chiński (Ch.R.L. z kilkoma kluczami i wartościami)

Dla każdych ustawień regionalnych na liście przykładowy kod wykonuje następujące czynności:

1. Tworzy nowy obiekt LocaleID.
2. Wyświetla różne właściwości obiektu LocaleID. Wyświetlane wartości różnią się w zależności od systemu operacyjnego i ustawionych preferencji użytkownika.
3. Wyświetla pełen zestaw kluczy i wartości obiektu 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);
            }
        }
    }
}