StringTools  - AS3

Bu StringTools nesnesi tarafından kullanılan gerçek yerel ayar kimliğinin adı.

İşletim sistemine ve StringTools() yapıcısına iletilen requestedLocaleIDName parametresinin değerine bağlı olarak, ad değeri için üç olasılık vardır.

1. İstenen yerel ayar LocaleID.DEFAULT değilse ve işletim sistemi, istenen yerel ayar için destek sağlıyorsa, döndürülen ad, requestedLocaleIDName özelliğiyle aynı olacaktır.
2. LocaleID.DEFAULT, yapıcıya requestedLocaleIDName parametresinin değeri olarak kullanıldıysa, kullanıcının işletim sistemi tarafından belirtilen geçerli yerel ayarın adı kullanılır. LocaleID.DEFAULT değeri, OS'de kullanıcının özelleştirilmiş ayarını saklar. requestedLocaleIDName parametresi olarak açık bir değerin iletilmesi, iki yerel ayar kimliği aynı olsa da, LocaleID.DEFAULT kullanılmasıyla aynı sonucu vermeyebilir. Kullanıcı makinesinde yerel ayarları özelleştirmiş olabilir ve LocaleID.DEFAULT öğesini kullanmak yerine açık yerel ayar kimlik adı isteyerek uygulamanız bu özelleştirilmiş ayarları almaz.
3. Sistem, yapıcıda belirtilen requestedLocaleIDName öğesini desteklemiyorsa, bir geri dönüş yerel ayarı kimlik adı sağlanır.

İlgili API Öğeleri

Bu StringTools nesnesinin gerçekleştirdiği en son işlemin durumu. Bu sınıfın bir yapıcısı veya yöntemi her çağrıldığında ya da başka bir özellik ayarlandığında lastOperationStatus özelliği ayarlanır. Olası değerler için, her bir yöntemin açıklamasına bakın.

İlgili API Öğeleri

Bu StringTools nesnesinin yapıcısına iletilmiş olan istenen yerel ayar kimliğinin adı.

LocaleID.DEFAULT değeri kullanıldıysa, döndürülen ad "i-default" olur. Geri dönüş yerel ayarı uygulandığında, gerçek yerel ayar, istenen yerel ayardan farklılık gösterebilir. Gerçek yerel ayarın adı, actualLocaleIDName özelliği kullanılarak alınabilir.

İlgili API Öğeleri

Büyük/küçük harf dönüştürme ve verili bir yerel ayarın kurallarına göre başka hizmet programları sağlayan yeni bir StringTools nesnesi oluşturur.

Bu yapıcı, geçerli işletim sisteminin istenen yerel ayar kimliği adını destekleyip desteklemediğini belirler. Desteklenmiyorsa, bunun yerine geri dönüş yerel ayarı kullanılır. Bir geri dönüş yerel ayarı kullanılırsa, lastOperationStatus özelliği geri dönüş türünü belirtir ve actualLocaleIDName özelliği, geri dönüş yerel ayar kimliğinin adını içerir.

Bu yapıcı başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

İstenen yerel ayar kimlik adı kullanılamıyorsa, lastOperationStatus öğesi şu değerlerden birine ayarlanır:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

İlgili API Öğeleri

Bu sınıf tarafından desteklenen tüm yerel ayar kimlik adlarını listeler.

Bu sınıf geçerli işletim sisteminde desteklenmiyorsa, bu yöntem null değerini döndürür.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Bir dizeyi dil kurallarına dayanarak küçük harfe dönüştürür. Yerel ayara bağlı olarak, çıktı dizesinin uzunluğu girdi dizesinin uzunluğundan farklı olabilir.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

Bir dizeyi dil kurallarına dayanarak büyük harfe dönüştürür. Yerel ayara bağlı olarak, çıktı dizesinin uzunluğu girdi dizesinin uzunluğundan farklı olabilir.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

Bu örnek aşağıdaki adımları izler:

1. Bir StringTools nesnesi oluşturur.
2. Türkçe, Yunanca, Almanca dillerine özel karakterlere sahip üç dize tanımlar.
3. Her dizeyi büyük ve küçük harfe çevirir ve sonuçları görüntüler. Bu örnek Türkçe "ı" ve "Ä°", Almanca "ß" ve Yunanca "Σςσ" gibi karakterlere ilişkin yerel ayara özgü davranışları gösterir.

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