LocaleID  - AS3

Status för den senaste åtgärden som detta LocaleID-objekt har utfört. Egenskapen lastOperationStatus anges när konstruktorn eller en metod för den här klassen anropas eller när en annan egenskap anges. Beskrivningarna av de olika metoderna innehåller information om möjliga värden.

Relaterade API-element

Returnerar ett mer ”kanoniskt” språk-ID.

Den här metoden utför följande konvertering av språk-ID:t för att ge det en mer kanoniskt form.

• Gemener/versaler återges korrekt för alla komponenter.
• Understreck konverteras till bindestreck.

Inge ytterligare bearbetning utförs. Alias ersätts till exempel inte, och inga element läggs till eller tas bort.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Skapar ett nytt LocaleID-objekt, förutsatt att ett språknamn angetts. Språknamnet måste följa den syntax som definieras av Unicode Technical Standard #35 (http://unicode.org/reports/tr35/).

När konstruktorn slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

När det begärda språk-ID:t inte är tillgängligt ställs lastOperationStatus in på något av följande:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Mer information om de varningsmeddelanden som visas ovan och andra möjliga värden för egenskapen lastOperationStatus finns i beskrivningarna för klassen LastOperationStatus.

Relaterade API-element

Returnerar en lista med godtagbara språk baserat på en lista över önskade språk och en lista över språk som för tillfället är tillgängliga.

Listan sorteras enligt angivna inställningar.

Detta är ett vanligt användningssätt för den här metoden:

• Användaren anger en lista med språk som han/hon förstår (sparas i en användarprofil, en webbläsarinställning eller en cookie-fil). Användaren anger de språk han/hon förstår bäst först, så att ordningen på språken i listan är relevant. Detta är ”önske"-listan.
• Programmet lokaliseras till ett flertal olika språk. Detta är ”finns”-listan.
• Metoden determinePreferredLocales() returnerar en kombination av de båda listorna, sorterad så att användarens önskade språk kommer först.

Om den här funktionen inte stöds på det aktuella operativsystemet returnerar metoden värdet null.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Returnerar ett objekt som innehåller alla nyckel-/värdepar från LocaleID-objektet.

Det returnerade objektet är strukturerat som en associativ array eller hash-tabell, där varje egenskapsnamn motsvarar en nyckel och värdet på egenskapen är värdet för nyckeln. I följande kod visas till exempel alla nycklar och värden som hämtats från LocaleID-objektet med metoden getKeysAndValues():

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

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Returnerar den språkkod som anges av språk-ID:t.

Om det inte går att tolka språknamnet korrekt är språkkoden samma som det fullständiga språknamnet.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Returnerar den regionkod som anges av språk-ID:t.

Den här metoden returnerar en tom sträng om det inte går att tolka eller gissa regionkoden. Detta kan inträffa om ett okänt eller ofullständigt språknamn som "xy" används. Regionkoden kontrolleras inte mot någon lista. Den regionkod som exempelvis returneras för språk-ID:t "xx-YY" är "YY".

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

Om regionen inte ingår i det angivna språknamnet hämtas den mest troliga regionkoden genom ”gissning”, och egenskapen lastOperationStatus ställs in på LastOperationStatus.USING_FALLBACK_WARNING.

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Returnerar den skriptkod som anges av språk-ID:t.

Den här metoden returnerar en tom sträng om det inte går att tolka eller gissa skriptkoden. Detta kan inträffa om ett okänt eller ofullständigt språknamn som "xy" används. Skriptkoden kontrolleras inte mot någon lista. Den skriptkod som exempelvis returneras för språk-ID:t "xx-Abcd-YY" är "Abcd".

Regionen kan förutom språket påverka returvärdet. Skriptkoden för "mn-MN" (mongoliska-Mongoliet) är till exempel "Cyrl" (Kyrilliska), medan skriptkoden för "mn-CN" (mongoliska-Kina) är "Mong" (mongoliska).

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

Om skriptkoden inte ingår i det angivna språknamnet hämtas den mest troliga skriptkoden genom ”gissning”, och egenskapen lastOperationStatus ställs in på LastOperationStatus.USING_FALLBACK_WARNING.

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Returnerar den språkvariantkod som anges av språk-ID:t.

Den här metoden returnerar en tom sträng om det inte finns någon språkvariantkod i det angivna språk-ID:t. (Inga gissningar behövs, eftersom få språk har eller behöver en språkvariant.)

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Anger om textriktningen för det angivna språket är höger till vänster.

Resultatet kan användas för att fastställa textriktningen i Flash-textmotorn och för att avgöra om användargränssnittet ska speglas för att ge stöd för den aktuella textriktningen.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Relaterade API-element

Anger att användarens standardinställningar för språk ska användas, enligt dennes operativsysteminställningar. Sådana inställningar anges vanligtvis i Kontrollpanelen i Windows eller i systeminställningarna i Mac OS X.

Användning av inställningen LocaleID.DEFAULT kan resultera i att olika språk-ID:n används för olika typer av åtgärder. Till exempel kanske ett visst språk används för sortering och ett annat för formatering. Denna flexibilitet är helt i enlighet med användarens inställningar och klassen fungerar på detta sätt enligt dess design.

Det är inte alltid som det här språk-ID:t är det mest lämpliga. För program som körs i webbläsaren kan webbläsarens språk vara ett bättre alternativ. Det är oftast en bra idé att låta användaren ändra inställningen för önskat språk och spara den i en användarprofil, cookie-fil eller i ett delat objekt.

I det här exemplet används följande språk: arabiska (Saudiarabien), engelska (USA), engelska (USA, POSIX-variant), kinesiska (Kina), kinesiska (Taiwan), kinesiska (förenklad Han-skrift), kinesiska (Kina, med flera nycklar och värden).

I exemplet utförs följande för varje språk i listan:

1. Skapar ett nytt LocaleID-objekt.
2. Visar olika egenskaper för LocaleID. Det värde som visas skiljer sig åt beroende på vilket operativsystem och vilka användarinställningar som används.
3. Visar den fullständiga uppsättningen med nycklar och värden för 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);
            }
        }
    }
}