StringTools  - AS3

De naam van de daadwerkelijke landinstellings-id die door dit StringTools-object wordt gebruikt.

Er zijn drie mogelijke waarden voor de naam, afhankelijk van het besturingssysteem en de waarde van de requestedLocaleIDName-parameter die wordt doorgegeven aan de StringTools()-constructor.

1. Als de aangevraagde landinstelling niet gelijk is aan LocaleID.DEFAULT en het besturingssysteem ondersteuning voor de aangevraagde landinstelling biedt, is de geretourneerde naam gelijk aan de eigenschap requestedLocaleIDName.
2. Als LocaleID.DEFAULT is gebruikt als waarde voor de parameter requestedLocaleIDName aan de constructor, wordt de naam van de huidige landinstelling zoals opgegeven door het besturingssysteem van de gebruiker gebruikt. Met de waarde LocaleID.DEFAULT blijft de aangepaste gebruikersinstelling in het besturingssysteem behouden. Als u een expliciete waarde doorgeeft als parameter requestedLocaleIDName, krijgt u niet noodzakelijkerwijs hetzelfde resultaat als wanneer u LocaleID.DEFAULT gebruikt, ook al zijn beide namen voor de landinstellings-id's gelijk. Misschien heeft de gebruiker de landinstellingen op de computer aangepast. Doordat u een expliciete naam van een landinstellings-id aanvraagt (en niet LocaleID.DEFAULT gebruikt), worden deze aangepaste instellingen niet door uw toepassing opgehaald.
3. Als het systeem geen ondersteuning biedt voor derequestedLocaleIDName die in de constructor is opgegeven, wordt een fallback-landinstellings-id gebruikt.

Verwante API-elementen

De status van de meest recente bewerking die door dit object StringTools is uitgevoerd. De eigenschap lastOperationStatus wordt ingesteld wanneer de constructor of een methode van deze klasse wordt aangeroepen of wanneer een andere eigenschap wordt ingesteld. Zie de beschrijving van de verschillende methoden voor de mogelijke waarden.

Verwante API-elementen

De naam van de aangevraagde landinstellings-id die is doorgegeven aan de constructor van dit StringTools-object.

Als u de waarde LocaleID.DEFAULT hebt gebruikt, is de geretourneerde naam 'i-default'. Als een fallback-landinstelling wordt toegepast, kan de werkelijk gebruikte landinstelling afwijken van de aangevraagde landinstelling. De naam van de werkelijke landinstelling kan worden opgehaald met de eigenschap actualLocaleIDName.

Verwante API-elementen

Hiermee wordt een nieuw object StringTools samengesteld dat voorziet in omzetting tussen hoofdletters en kleine letters en andere functies volgens de conventies van een bepaalde landinstelling.

Deze constructor bepaalt of het huidige besturingssysteem ondersteuning biedt voor de aangevraagde naam van de landinstellings-id. Als er geen ondersteuning is, wordt een fallback-landinstelling gebruikt. Als een fallback-landinstelling wordt gebruikt, geeft de eigenschap lastOperationStatus het type fallback aan en bevat de eigenschap actualLocaleIDName de naam van de fallback-landinstellings-id.

Wanneer deze constructor is voltooid, wordt de lastOperationStatus-eigenschap ingesteld op:

• LastOperationStatus.NO_ERROR

Wanneer de aangevraagde naam voor de landinstellings-id niet beschikbaar is, wordt lastOperationStatus ingesteld op een van de volgende waarden:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

In het andere geval wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die in de LastOperationStatus-klasse worden gedefinieerd.

Verwante API-elementen

Biedt een overzicht van alle namen van landinstellings-id's die door deze klasse worden ondersteund.

Als deze klasse niet word ondersteund op het huidige besturingssysteem, retourneert deze methode de waarde null.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Converteert een tekenreeks in kleine letters volgens de taalconventies. Afhankelijk van de landinstelling kan de lengte van de uitvoertekenreeks verschillen van de lengte van de invoertekenreeks.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

Verwante API-elementen

Converteert een tekenreeks in hoofdletters volgens de taalconventies. Afhankelijk van de landinstelling kan de lengte van de uitvoertekenreeks verschillen van de lengte van de invoertekenreeks.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

Verwante API-elementen

In dit voorbeeld worden de volgende stappen uitgevoerd:

1. Maakt een StringTools-object.
2. Definieert drie tekenreeksen met tekens die uniek zijn voor de talen Turks, Grieks en Duits.
3. Converteert elke tekenreeks in hoofdletters en kleine letters en geeft de resultaten weer. In dit voorbeeld wordt interessant landinstellingsafhankelijk gedrag weergegeven voor tekens zoals de Turkse "ı" en "İ", de Duitse "ß" en de Griekse "Σςσ".

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;
        }
    }
}