LocaleID  - AS3

Bu LocaleID 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

Biraz daha "kurallı" bir yerel ayar kimliği döndürür.

Bu yöntem, yerel ayar kimlik adına daha kurallı bir form vermek için şu dönüştürmeyi gerçekleştirir.

• Tüm bileşenlere uygun büyük/küçük harf uygulanır.
• Alt çizgiler kısa çizgilere dönüştürülür.

Ek bir işleme gerçekleştirilmez. Örneğin, diğer adlar değiştirilmez ve herhangi bir öğe eklenmez veya kaldırılmaz.

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 yerel ayar adı verilmiş yeni bir LocaleID nesnesi oluşturur. Yerel ayar adı, Unicode Technical Standard #35 (http://unicode.org/reports/tr35/) tarafından tanımlanan sözdizimine uymalıdır.

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.

Yukarıda listelenen uyarılar ve lastOperationStatus özelliğinin diğer olası değerleri hakkında ayrıntılı bilgi için, LastOperationStatus sınıfındaki açıklamalara bakın.

İlgili API Öğeleri

İstenen yerel ayarların listesine ve geçerli olarak kullanılabilir olan yerel ayarların listesine göre kabul edilebilir yerel ayarların bir listesini döndürür.

Sonuçta elde edilen liste, tercih sırasına göre sıralanır.

Aşağıda, bu yönteme yönelik tipik bir kullanım durumu verilmiştir:

• Kullanıcı anladığı dillerin bir listesini belirtir (bir kullanıcı profilinde, tarayıcı ayarında veya tanımlama bilgisinde saklanır). Kullanıcı en iyi anladığı dilleri listenin başına koyar, böylece listedeki dillerin sırası alakalıdır. Bu "istenenler" listesidir.
• Uygulama çok sayıda farklı dilde yerelleştirilmiştir. Bu "sahip olunanlar" listesidir.
• determinePreferredLocales() yöntemi, kullanıcının tercih edilen dilleri ilk önce gelecek şekilde, iki listenin bir kesişimini döndürür.

Bu özellik 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.

Parametreler

İlgili API Öğeleri

LocaleID nesnesindeki tüm anahtar ve değer çiftleri içeren bir nesne döndürür.

Döndürülen nesne, her bir özellik adının bir anahtarı temsil ettiği ve özellik değerinin o anahtarın değeri olduğu karma tablo veya ilişkilendirilebilir dizi olarak yapılandırılır. Örneğin, aşağıdaki kod getKeysAndValues() yöntemi kullanılarak LocaleID nesnesinden alınan tüm anahtarları ve değerleri listeler:

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

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.

İlgili API Öğeleri

Yerel ayar kimlik adı tarafından belirtilen dil kodunu döndürür.

Yerel ayar adı düzgün şekilde ayrıştırılamazsa, dil kodu tam yerel ayar adıyla aynı olur.

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.

İlgili API Öğeleri

Yerel ayar kimlik adı tarafından belirtilen bölge kodunu döndürür.

Bölge kodu ayrıştırılamıyorsa veya tahmin edilemiyorsa, bu yöntem boş bir dize döndürür. Bu, "xy" gibi bilinmeyen veya eksik bir yerel ayar kimlik adı kullanıldığında oluşabilir. Bölge kodu sabit bir listeye karşı doğrulanmaz. Örneğin, "xx-YY" yerel ayar kimlik adı için döndürülen bölge kodu, "YY" olur.

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

• LastOperationStatus.NO_ERROR

Bölge, belirtilen yerel ayar adının parçası değilse, yerel ayar için en yakın olabilecek bölge kodu "tahmin edilir" ve lastOperationStatus özelliği LastOperationStatus.USING_FALLBACK_WARNING olarak ayarlanır.

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

İlgili API Öğeleri

Yerel ayar kimlik adı tarafından belirtilen komut dosyası kodunu döndürür.

Komut dosyası kodu ayrıştırılamıyorsa veya tahmin edilemiyorsa, bu yöntem boş bir dize döndürür. Bu, "xy" gibi bilinmeyen veya eksik bir yerel ayar kimlik adı kullanıldığında oluşabilir. Komut dosyası kodu sabit bir listeye karşı doğrulanmaz. Örneğin, "xx-Abcd-YY" yerel ayar kimlik adı için döndürülen komut dosyası kodu, "Abcd" olur.

Bölge ve dil de döndürme değerini etkileyebilir. Örneğin, "mn-MN" (Moğolca-Moğolistan) için komut dosyası kodu "Cyrl" (Kiril) olurken, "mn-CN" (Moğolca-Çin) için komut dosyası kodu, "Mong" (Moğolca) olur.

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

• LastOperationStatus.NO_ERROR

Komut dosyası, belirtilen yerel ayar adının parçası değilse, en yakın olabilecek komut dosyası kodu "tahmin edilir" ve lastOperationStatus özelliği LastOperationStatus.USING_FALLBACK_WARNING olarak ayarlanır.

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

İlgili API Öğeleri

Yerel ayar kimlik adı tarafından belirtilen dil varyantı kodunu döndürür.

Verilen yerel ayar kimlik adında bir dil varyantı kodu yoksa, bu yöntem boş bir dize döndürür. (Çok az yerel ayarın bir varyantı olduğundan veya bir dil varyantına ihtiyacı olduğundan, tahmin gerekmez.)

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.

İlgili API Öğeleri

Belirtilen yerel ayar için metin yönünün sağdan sola olup olmadığını belirtir.

Sonuç, Flash metin motorunda metnin yönünü belirlemek ve geçerli metin yönünü desteklemek için kullanıcı arabiriminin yansıtılıp yansıtılmayacağına karar vermek için kullanılabilir.

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.

İlgili API Öğeleri

Kullanıcının işletim sistemi ayarlarında belirtildiği gibi, kullanıcının varsayılan dil tercihlerinin kullanılması gerektiğini belirtir. Örneğin, bu tür tercihler genellikle Windows'ta "Denetim Masası"ndan veya Mac OSX'te "Sistem Tercihleri"nden yapılır.

LocaleID.DEFAULT ayarının kullanılması, farklı işlem türleri için farklı yerel ayar kimlik adı kullanılmasıyla sonuçlanabilir. Örneğin, bir yerel ayar sıralama için kullanılırken, diğeri de biçimlendirme için kullanılabilir. Bu esneklik kullanıcı tercihlerine uyar ve sınıf tasarım gereği bu şekilde hareket eder.

Bu yerel ayar kimliği her zaman kullanılacak en uygun kimlik değildir. Tarayıcıda çalışan uygulamalar için, tarayıcının tercih edilen yerel ayarı daha iyi bir tercih olabilir. Genellikle, kullanıcının tercih edilen yerel ayar kimlik adı ayarını değiştirmesine izin vermek ve bu tercihi bir kullanıcı profilinde, tanımlama bilgisinde veya paylaşılan nesnede saklamak iyi bir fikirdir.

Bu örnek şu yerel ayarları kullanır: Arapça (Suudi Arabistan), İngilizce (ABD), İngilizce (ABD, POSIX varyantı), Çince (ÇHC), Çince (Tayvan), Çince (Basitleştirilmiş Han Yazısı), Çince (Birçok anahtar ve değer ile ÇHC)

Aşağıdaki örnek listedeki her yerel ayar için aşağıdakileri yapar:

1. Yeni bir LocaleID nesnesi oluşturur.
2. LocaleID'nin çeşitli özelliklerini görüntüler. Gösterilen değerler işletim sisteminize ve kullanıcı tercihlerinize bağlı olarak farklılık gösterir.
3. LocaleID'ye ilişkin anahtar ve değerler kümesinin tamamını görüntüler.

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