StringTools  - AS3

Namnet på det faktiska språk-ID som används av det här StringTools-objektet.

Det finns tre möjliga värden för namnet, beroende på operativsystemet och värdet på den requestedLocaleIDName-parameter som skickas till StringTools()-konstruktorn.

1. Om det begärda språket inte var LocaleID.DEFAULT, och operativsystemet har stöd för det begärda språket, är det namn som returneras samma som egenskapen requestedLocaleIDName.
2. Om LocaleID.DEFAULT användes som värdet för parametern requestedLocaleIDName till konstruktorn, används det namn för det aktuella språket som specificeras av användarens operativsystem. Värdet LocaleID.DEFAULT bevarar användarens anpassade inställningar i operativsystemet. Om du skickar ett uttryckligt värde som requestedLocaleIDName-parameter ger det inte nödvändigtvis samma resultat som när du använder LocaleID.DEFAULT, även om de båda språknamnen är samma. Användaren kan ha anpassat språkinställningarna på datorn, och om han/hon begär ett uttryckligt språk-ID i stället för att använda LocaleID.DEFAULT hämtar ditt program inte dessa anpassade inställningar.
3. Om systemet saknar stöd för det requestedLocaleIDName som anges i konstruktorn används ett reservspråk-ID i stället.

Relaterade API-element

Status för den senaste åtgärden som detta StringTools-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

Namnet på det begärda språk-ID som skickades till konstruktorn för det här StringTools-objektet.

Om värdet LocaleID.DEFAULT användes returneras namnet "i-default". Det språk som faktiskt används kan skilja sig från det begärda språket när ett reservspråk används. Namnet på det faktiska språket kan hämtas med egenskapen actualLocaleIDName.

Relaterade API-element

Skapar ett nytt StringTools-objekt som tillhandahåller konvertering av gemener/versaler och andra verktyg i enlighet med reglerna för ett visst språk.

Den här konstruktorn avgör om det aktuella operativsystemet har stöd för det begärda språk-ID:t. Om det inte stöds används ett reservspråk i stället. Om ett reservspråk används visar egenskapen lastOperationStatus dess typ, och egenskapen actualLocaleIDName innehåller namnet på reservspråkets-ID:t.

När den hä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.

Relaterade API-element

Visar alla språk-ID:n som stöds i den här klassen.

Om den här klassen 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.

Konverterar en sträng till gemener i enlighet med språkets regler. Beroende på språk kan längden på utdatasträngen skilja sig från längden på indatasträngen.

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

Konverterar en sträng till versaler i enlighet med språkets regler. Beroende på språk kan längden på utdatasträngen skilja sig från längden på indatasträngen.

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

Följande steg utförs i det här exemplet:

1. Skapar ett StringTools-objekt.
2. Definierar tre strängar med tecken som är unika för turkiska, grekiska och tyska.
3. Konverterar alla strängar till versaler och gemener och visar resultatet. Det här exemplet illustrerar intressanta språkspecifika karaktärsdrag, som turkiskans "ı" och "Ä°", tyskans "ß" och grekiskans "Σςσ".

package {
    import flash.display.Sprite;
    import flash.globalization.LocaleID;
    import flash.globalization.StringTools;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class StringToolsExample extends Sprite
    {
        public function StringToolsExample()
        {
            var localeName:String= LocaleID.DEFAULT;
            var strTool:StringTools = new StringTools(localeName);
            
            trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName 
            + "; actual: " + nf.actualLocaleIDName);
            trace( "Last Operation Status:" + nf.lastOperationStatus );  
            
            var turkishStr:String = "iI ıİ";
            var greekStr:String = "Σςσβΰ�Σ";
            var germanStr:String= "ß";
            
            var tfTurInp:TextField = createTextField(10, 10);
            tfTurInp.text="Turkish Input: \t " + turkishStr;
            
            var tfdash:TextField = createTextField(10, 20);
            tfdash.text="-------------------";
            
            var tf1:TextField = createTextField(10, 30);
            tf1.text="\t Upper case: \t " + strTool.toUpperCase(turkishStr);
            
            var tf2:TextField = createTextField(10, 40);
            tf2.text="\t Lower case: \t " + strTool.toLowerCase(turkishStr);
            
            var tfgreekInp:TextField = createTextField(10, 60);
            tfgreekInp.text="Greek Input: \t " + greekStr;
            
            var tfdash1:TextField = createTextField(10, 70);
            tfdash1.text="-------------------";
            
            var tf3:TextField = createTextField(10, 80);
            tf3.text="\t Upper case: \t " + strTool.toUpperCase(greekStr);
            
            var tf4:TextField = createTextField(10, 90);
            tf4.text="\t Lower case: \t " + strTool.toLowerCase(greekStr);
            
            var tfgermanInp:TextField = createTextField(10, 110);
            tfgermanInp.text="German Input: \t " + germanStr;
            
            var tfdash2:TextField = createTextField(10, 120);
            tfdash2.text="-------------------";
                         
            var tf5:TextField = createTextField(10, 130);
            tf5.text="\t Upper case: \t " + strTool.toUpperCase(germanStr);
            
            var tf6:TextField = createTextField(10, 140);
            tf6.text="\t Lower case: \t " + strTool.toLowerCase(germanStr);
        }
        
        private function createTextField(x:Number, y:Number):TextField 
        {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.autoSize=TextFieldAutoSize.LEFT;
            addChild(result);
            return result;
        }
    }
}