Paket | fl.lang |
Sınıf | public class Locale |
Miras Alma | Locale EventDispatcher Object |
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
-
"çalışma süresinde otomatik"
—Flash Player, dize kimliklerini flash.system.capabilities.language tarafından döndürülen varsayılan sistem dil kodu ile eşleşen XML dosyası dizeleriyle değiştirir. -
"sahne alanı dilini kullanarak elle"
—Dize kimlikleri, derleme süresindeki dizelerle değiştirilir ve Flash Player tarafından değiştirilemez. -
"çalışma süresinde ActionScript ile"
—Dize kimliği değiştirme işlemi, çalışma süresinde ActionScript kullanılarak kontrol edilir. Bu seçenek, dize kimliği değiştirme işleminin zamanlamasını ve dilini kontrol etmenize olanak tanır.
Dize kimliklerini “çalışma zamanında ActionScript ile“ değiştirmek istediğinizde bu sınıfın özelliklerini ve yöntemlerini kullanabilirsiniz.
Kullanılabilir özelliklerin ve yöntemlerin tümü statiktir. Bu, özelliklere ve yöntemlere sınıfın bir örneğiyle değil de, fl.lang.Locale sınıfının kendisiyle erişildiği anlamına gelir.
Not: Locale sınıfı, Flash Geliştirme sınıfyoluna yüklenir ve otomatik olarak SWF dosyalarınızın içine derlenir. Locale sınıfı SWF'nin içine derlendiğinden bu sınıfın kullanılması az miktarda da olsa SWF dosya boyutunu artırır.
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
autoReplace : Boolean [statik]
XML dosyası yüklendikten sonra dizelerin otomatik olarak değiştirilip değiştirilmeyeceğini belirler. | Locale | ||
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
languageCodeArray : Array [statik] [salt okunur]
Belirlenmiş veya FLA dosyasına yüklenmiş diller için dil kodlarını içeren dizi. | Locale | ||
stringIDArray : Array [statik] [salt okunur]
FLA dosyasındaki tüm dize kimliklerini içeren dizi. | Locale |
Yöntem | Tanımlayan: | ||
---|---|---|---|
[statik]
Sonradan kullanılmak üzere, {instance, string ID} çiftini dahili diziye ekler. | Locale | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | EventDispatcher | ||
[statik]
Sonradan kullanılmak üzere, {languageCode ve languagePath} çiftini dahili diziye ekler. | Locale | ||
[statik]
XML dosyası yüklü ise true, yoksa false döndürür. | Locale | ||
Olay akışına bir olay gönderir. | EventDispatcher | ||
[statik]
Dizeler paneli iletişim kutusunda veya setDefaultLang() yöntemi çağrılarak belirlenen, varsayılan dil kodu. | Locale | ||
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
[statik]
Kullanılacak dili otomatik olarak belirler ve XML dil dosyasını yükler. | Locale | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
[statik]
Belirtilen XML dil dosyasını yükler. | Locale | ||
[statik]
Geçerli dildeki belirli bir dize kimliğiyle ilişkilendirilmiş dize değerini döndürür. | Locale | ||
[statik]
Belirli bir dize kimliği ve dil koduyla ilişkilendirilmiş dize değerini döndürür. | Locale | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
[statik]
Varsayılan dil kodunu ayarlar. | Locale | ||
[statik]
XML dosyası yüklendikten sonra çağrılan geri çağırma işlevini ayarlar. | Locale | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
[statik]
Belirli bir dize kimliği ve dil kodunun yeni dize değerini ayarlar. | Locale | ||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | ||
Belirtilen nesnenin temel değerini döndürür. | Object | ||
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | EventDispatcher |
autoReplace | özellik |
autoReplace:Boolean
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
XML dosyası yüklendikten sonra dizelerin otomatik olarak değiştirilip değiştirilmeyeceğini belirler. true
olarak ayarlanırsa metin değiştirme yöntemi Dizeler panelindeki "çalışma süresinde otomatik"
ayarına eşdeğerdir. Bu, Flash Player'ın ana bilgisayar ortamının varsayılan dilini belirleyeceği ve o dildeki metni otomatik olarak görüntüleyeceği anlamına gelir. false
olarak ayarlanırsa metin değiştirme yöntemi Dizeler panelindeki"çalışma süresinde ActionScript ile"
ayarına eşdeğerdir. Bu, metni görüntülemek için uygun XML dosyasını yüklemekten sizin sorumlu olduğunuz anlamına gelir.
Bu özelliğin varsayılan değeri, Dizeler paneli iletişim kutusunda Dizeleri değiştir için seçtiğiniz ayarı yansıtır: "çalışma süresinde otomatik"
için true
ve "çalışma süresinde ActionScript ile" için false
.
Uygulama
public static function get autoReplace():Boolean
public static function set autoReplace(value:Boolean):void
Örnek ( Bu örnek nasıl kullanılır? )
greeting_txt
metin alanını İngilizce XML dosyasındaki IDS_GREETING
dizesinin içeriğiyle doldurmak için Locale.autoReplace
özelliği kullanılmaktadır. Dizeler panelinde, Ayarlar iletişim kutusunu açmak için Ayarlar düğmesini tıklatın. Ayarlar iletişim kutusunu kullanarak İngilizce (en) ve Fransızca (fr) gibi iki etkin dil ekleyebilir, dizeleri değiştirme radyo seçeneğini "çalışma süresinde ActionScript ile"
olarak ayarlayıp Tamam'ı tıklatabilirsiniz. Son olarak Dizeler panelinde bir IDS_GREETING dize kimliği girin ve her etkin dil için metin ekleyin.
var greeting_txt:TextField = new TextField(); greeting_txt.x = 40; greeting_txt.y = 40; greeting_txt.width = 200; greeting_txt.height = 20; greeting_txt.autoSize = TextFieldAutoSize.LEFT; Locale.autoReplace = true; Locale.addDelayedInstance(greeting_txt, "IDS_GREETING"); Locale.loadLanguageXML("en");
languageCodeArray | özellik |
languageCodeArray:Array
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
Belirlenmiş veya FLA dosyasına yüklenmiş diller için dil kodlarını içeren dizi. Dil kodları alfabetik biçimde sıralanmamıştır.
Uygulama
public static function get languageCodeArray():Array
Örnek ( Bu örnek nasıl kullanılır? )
lang_cb
örnek adını verin. Metin aracını kullanarak dinamik metin alanı oluşturun ve alana greeting_txt
örnek adını verin. Dizeler panelinde en az iki etkin dil ekleyin, dizeleri değiştir radyo seçeneğini "çalışma süresinde ActionScript ile"
olarak ayarlayın ve Tamam'ı tıklatın. Ardından, bir IDS_GREETING dize kimliği ekleyin ve her etkin dil için metin girin. Son olarak, şu ActionScript kodunu ana Zaman Çizelgesi'ndeki Kare 1'e ekleyin:
Locale.setLoadCallback(localeListener); lang_cb.dataProvider = Locale.languageCodeArray.sort(); lang_cb.addEventListener("change", langListener); function langListener(eventObj:Object):void { Locale.loadLanguageXML(eventObj.target.value); } function localeListener(success:Boolean):void { if (success) { greeting_txt.text = Locale.loadString("IDS_GREETING"); } else { greeting_txt.text = "unable to load language XML file."; } }
stringIDArray | özellik |
stringIDArray:Array
[salt okunur] Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
FLA dosyasındaki tüm dize kimliklerini içeren dizi. Dize kimlikleri alfabetik biçimde sıralanmamıştır.
Uygulama
public static function get stringIDArray():Array
Örnek ( Bu örnek nasıl kullanılır? )
Locale.stringIDArray
özelliğini izler. Ayarlar iletişim kutusunu açmak için Dizeler panelindeki Ayarlar düğmesini tıklatın. Ardından iki etkin dil ekleyin: İngilizce (en) ve Fransızca (fr), dizeleri değiştir radyo kontrolünü "çalışma süresinde ActionScript ile"
olarak ayarlayın ve Tamam'ı tıklatın. Dizeler panelinde, bir IDS_GREETING dize kimliği ekleyin ve ardından her etkin dil için metin ekleyin.
Locale.setLoadCallback(localeCallback); Locale.loadLanguageXML("fr"); function localeCallback(success:Boolean) { trace(success); trace(Locale.stringIDArray); // IDS_GREETING trace(Locale.loadStringEx("IDS_GREETING", "fr")); // bonjour }
addDelayedInstance | () | yöntem |
public static function addDelayedInstance(instance:Object, stringID:String):*
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
Sonradan kullanılmak üzere, {instance, string ID} çiftini dahili diziye ekler. Bu, dize değiştirme yöntemi "çalışma süresinde otomatik"
olduğunda öncelikle Flash tarafından kullanılır.
Parametreler
instance:Object — Doldurulacak metin alanının örnek adı.
| |
stringID:String — Dil dizesi kimliği.
|
* |
Örnek ( Bu örnek nasıl kullanılır? )
IDS_GREETING
dizesiyle doldurmak için autoReplace
özelliği ve addDelayedInstance()
yöntemi kullanılmaktadır.
greeting_txt.autoSize = TextFieldAutoSize.LEFT; Locale.autoReplace = true; Locale.addDelayedInstance(greeting_txt, "IDS_GREETING"); Locale.loadLanguageXML("en");
addXMLPath | () | yöntem |
public static function addXMLPath(langCode:String, path:String):void
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
Sonradan kullanılmak üzere, {languageCode ve languagePath} çiftini dahili diziye ekler. Bu, dizenin değiştirme yöntemi "çalışma zamanında otomatik"
veya "çalışma zamanında ActionScript ile"
olduğunda öncelikle Flash Player tarafından kullanılır. Bu yöntem, Flash Professional tarafından ayarlanan varsayılan konum yerine özel bir konumdan XML dil dosyalarını yüklemenize olanak sağlar. Varsayılan olarak Flash Professional, çalışma dizininizdeki her dil için FLA dosyanızın adıyla adlandırılmış bir alt dizinin altında XML dosyası oluşturur.
Parametreler
langCode:String — Dil kodu.
| |
path:String — Eklenecek XML yolu.
|
Örnek ( Bu örnek nasıl kullanılır? )
Locale.addXMLPath("en", "locale/locale_en.xml"); Locale.addXMLPath("fr", "locale/locale_fr.xml"); Locale.setLoadCallback(Delegate.create(this, languageLoaded)); Locale.loadLanguageXML("en"); private function languageLoaded(success:Boolean):Void { trace(Locale.loadString("IDS_HELLO");
checkXMLStatus | () | yöntem |
public static function checkXMLStatus():Boolean
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
XML dosyası yüklü ise true
, yoksa false
döndürür.
Boolean — XML dosyası yüklü ise true , yoksa false döndürür.
|
Örnek ( Bu örnek nasıl kullanılır? )
greeting_txt
metin alanı örneği, dil XML dosyasındaki IDS_GREETING
dizesiyle doldurulur.
Locale.setLoadCallback(localeCallback); Locale.loadLanguageXML("en"); // create interval to check if language XML file is loaded var locale_int:Number = setInterval(checkLocaleStatus, 10); function checkLocaleStatus():void { if (Locale.checkXMLStatus()) { clearInterval(locale_int); trace("clearing interval @ " + getTimer() + " ms"); } } // callback function for Locale.setLoadCallback() function localeCallback(success:Boolean):void { greeting_txt.text = Locale.loadString("IDS_GREETING"); }
getDefaultLang | () | yöntem |
public static function getDefaultLang():String
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
Dizeler paneli iletişim kutusunda veya setDefaultLang()
yöntemi çağrılarak belirlenen, varsayılan dil kodu.
String — Varsayılan dil kodunu döndürür.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
defLang
adlı bir değişken oluşturur. Ayarlar iletişim kutusunu açmak için Dizeler panelindeki Ayarlar düğmesini tıklatın. Ardından iki etkin dil ekleyin: İngilizce (en) ve Fransızca (fr), dizeleri değiştir radyo kontrolünü "çalışma süresinde ActionScript ile"
olarak ayarlayın ve Tamam'ı tıklatın. Dizeler panelinde, bir IDS_GREETING dize kimliği ekleyin ve ardından her etkin dil için metin ekleyin.
var defLang:String = "fr"; Locale.setDefaultLang(defLang); Locale.setLoadCallback(localeCallback); Locale.loadLanguageXML(Locale.getDefaultLang()); function localeCallback(success:Boolean) { if (success) { trace(Locale.stringIDArray); // IDS_GREETING trace(Locale.loadString("IDS_GREETING")); } else { trace("unable to load XML"); } }
initialize | () | yöntem |
public static function initialize():void
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
Kullanılacak dili otomatik olarak belirler ve XML dil dosyasını yükler. Bu, dize değiştirme yöntemi "çalışma süresinde otomatik"
olduğunda öncelikle Flash tarafından kullanılır.
Örnek ( Bu örnek nasıl kullanılır? )
greeting_txt
metin alanını otomatik olarak kullanıcının geçerli işletim sistemi diliyle doldurmak için initialize()
yönteminin nasıl kullanılacağı gösterilmektedir. Doğrudan initialize()
yöntemini kullanmak yerine "çalışma süresinde otomatik"
dize değiştirme yöntemini kullanın.
trace(System.capabilities.language); Locale.autoReplace = true; Locale.addDelayedInstance(greeting_txt, "IDS_GREETING"); Locale.initialize();
loadLanguageXML | () | yöntem |
public static function loadLanguageXML(xmlLanguageCode:String, customXmlCompleteCallback:Function = null):void
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
Belirtilen XML dil dosyasını yükler.
Parametreler
xmlLanguageCode:String — Yüklemek istediğiniz XML dil dosyasının dil kodu.
| |
customXmlCompleteCallback:Function (default = null ) — XML dil dosyası yüklendiğinde çağrılacak özel geri çağırma işlevi.
|
Örnek ( Bu örnek nasıl kullanılır? )
loadLanguageXML()
yöntemi kullanılmaktadır. Dil dosyası yüklendikten sonra localeCallback()
yöntemi çağrılır ve Sahne Alanı'ndaki greeting_txt
metin alanını XML dosyasındaki IDS_GREETING
dizesinin içeriğiyle doldurur.
Locale.setLoadCallback(localeCallback); Locale.loadLanguageXML("en"); // create interval to check if language XML file is loaded var locale_int:Number = setInterval(checkLocaleStatus, 10); function checkLocaleStatus():void { if (Locale.checkXMLStatus()) { clearInterval(locale_int); trace("clearing interval @ " + getTimer() + " ms"); } } // callback function for Locale.setLoadCallback() function localeCallback(success:Boolean):void { greeting_txt.text = Locale.loadString("IDS_GREETING"); }
loadString | () | yöntem |
public static function loadString(id:String):String
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
Geçerli dildeki belirli bir dize kimliğiyle ilişkilendirilmiş dize değerini döndürür.
Parametreler
id:String — Yüklenecek dizenin kimlik (ID) numarası.
|
String — Geçerli dildeki belirli bir dize kimliğiyle ilişkilendirilmiş dize değeri.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
greeting_txt
metin alanı örneği, XML dil dosyasındaki IDS_GREETING
dizesiyle doldurulur.
Locale.setLoadCallback(localeCallback); Locale.loadLanguageXML("en"); // create interval to check if language XML file is loaded var locale_int:Number = setInterval(checkLocaleStatus, 10); function checkLocaleStatus():void { if (Locale.checkXMLStatus()) { clearInterval(locale_int); trace("clearing interval @ " + getTimer() + " ms"); } } // callback function for Locale.setLoadCallback() function localeCallback(success:Boolean):void { greeting_txt.text = Locale.loadString("IDS_GREETING"); }
loadStringEx | () | yöntem |
public static function loadStringEx(stringID:String, languageCode:String):String
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
Belirli bir dize kimliği ve dil koduyla ilişkilendirilmiş dize değerini döndürür. Beklenmeyen XML dosya yüklemesini önlemek için loadStringEx
, XML dosyası zaten yüklü değilse XML dil dosyasını yüklemez. Bir XML dil dosyasını yüklemek istiyorsanız loadLanguageXML()
yöntemini çağırmak için doğru zamana karar vermeniz gerekir.
Parametreler
stringID:String — Yüklenecek dizenin kimlik (ID) numarası.
| |
languageCode:String — Dil kodu.
|
String — languageCode parametresi tarafından belirtilen dildeki belirli bir dize kimliğiyle ilişkilendirilmiş dize değeri.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
IDS_GREETING
dizesinin değerini izlemek için loadStringEx()
yöntemi kullanılmaktadır.
Locale.setLoadCallback(localeCallback); Locale.loadLanguageXML("fr"); function localeCallback(success:Boolean) { trace(success); trace(Locale.stringIDArray); // IDS_GREETING trace(Locale.loadStringEx("IDS_GREETING", "fr")); // bonjour }
setDefaultLang | () | yöntem |
public static function setDefaultLang(langCode:String):void
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
Varsayılan dil kodunu ayarlar.
Parametreler
langCode:String — Bir dil kodunu temsil eden dize.
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
defLang
adlı bir değişken oluşturur. Ayarlar iletişim kutusunu açmak için Dizeler panelindeki Ayarlar düğmesini tıklatın. Ardından iki etkin dil ekleyin: İngilizce (en) ve Fransızca (fr), dizeleri değiştir radyo kontrolünü "çalışma süresinde ActionScript ile"
olarak ayarlayın ve Tamam'ı tıklatın. Dizeler panelinde, bir IDS_GREETING dize kimliği ekleyin ve ardından her etkin dil için metin ekleyin.
var defLang:String = "fr"; Locale.setDefaultLang(defLang); Locale.setLoadCallback(localeCallback); Locale.loadLanguageXML(Locale.getDefaultLang()); function localeCallback(success:Boolean) { if (success) { trace(Locale.stringIDArray); // IDS_GREETING trace(Locale.loadString("IDS_GREETING")); } else { trace("unable to load XML"); } }
setLoadCallback | () | yöntem |
public static function setLoadCallback(loadCallback:Function):*
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
XML dosyası yüklendikten sonra çağrılan geri çağırma işlevini ayarlar.
Parametreler
loadCallback:Function — XML dil dosyası yüklendiğinde çağrılacak işlev.
|
* |
Örnek ( Bu örnek nasıl kullanılır? )
greeting_txt
metin alanı örneği, XML dil dosyasındaki IDS_GREETING
dizesiyle doldurulur.
Locale.setLoadCallback(localeCallback); Locale.loadLanguageXML("en"); // create interval to check if language XML file is loaded var locale_int:Number = setInterval(checkLocaleStatus, 10); function checkLocaleStatus():void { if (Locale.checkXMLStatus()) { clearInterval(locale_int); trace("clearing interval @ " + getTimer() + " ms"); } } // callback function for Locale.setLoadCallback() function localeCallback(success:Boolean):void { greeting_txt.text = Locale.loadString("IDS_GREETING"); }
setString | () | yöntem |
public static function setString(stringID:String, languageCode:String, stringValue:String):void
Dil Sürümü: | ActionScript 3.0 |
Ürün Sürümü: | Flash CS3 |
Çalışma Zamanı Sürümleri: | Flash Player 9, AIR 1.0 |
Belirli bir dize kimliği ve dil kodunun yeni dize değerini ayarlar.
Parametreler
stringID:String — Ayarlanacak dizenin kimlik (ID) numarası.
| |
languageCode:String — Dil kodu.
| |
stringValue:String — Bir dize değeri.
|
Örnek ( Bu örnek nasıl kullanılır? )
IDS_WELCOME
dizesini ayarlamak için setString()
yöntemi kullanılmaktadır.
Locale.setString("IDS_WELCOME", "en", "hello"); Locale.setString("IDS_WELCOME", "fr", "bonjour"); trace(Locale.loadStringEx("IDS_WELCOME", "en")); // hello
Tue Jun 12 2018, 01:09 PM Z