Locale - Adobe ActionScript® 3 (AS3 Flash) API Başvurusu

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

fl.lang.Locale sınıfı, çok dilli metnin bir SWF dosyasında nasıl görüntüleneceğini kontrol etmenize olanak tanır. Flash Dizeler paneli, dinamik metin alanlarında dize değişmezlerinin yerine dize kimliklerini kullanmanıza olanak verir. Bu, dile özgü bir XML dosyasından yüklenen metni görüntüleyen bir SWF dosyası oluşturmanızı sağlar. XML dosyası, XML Yerelleştirme Değişim Dosyası Biçimi'ni (XLIFF) kullanmalıdır. XLIFF dosyalarında bulunan dile özgü dizeleri görüntülemenin üç yolu vardır:

"ç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

flash.system.Capabilities.language

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Ö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

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		addDelayedInstance(instance:Object, stringID:String):* [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
		addXMLPath(langCode:String, path:String):void [statik] Sonradan kullanılmak üzere, {languageCode ve languagePath} çiftini dahili diziye ekler.	Locale
		checkXMLStatus():Boolean [statik] XML dosyası yüklü ise true, yoksa false döndürür.	Locale
		dispatchEvent(event:Event):Boolean Olay akışına bir olay gönderir.	EventDispatcher
		getDefaultLang():String [statik] Dizeler paneli iletişim kutusunda veya setDefaultLang() yöntemi çağrılarak belirlenen, varsayılan dil kodu.	Locale
		hasEventListener(type:String):Boolean EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder.	EventDispatcher
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		initialize():void [statik] Kullanılacak dili otomatik olarak belirler ve XML dil dosyasını yükler.	Locale
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		loadLanguageXML(xmlLanguageCode:String, customXmlCompleteCallback:Function = null):void [statik] Belirtilen XML dil dosyasını yükler.	Locale
		loadString(id:String):String [statik] Geçerli dildeki belirli bir dize kimliğiyle ilişkilendirilmiş dize değerini döndürür.	Locale
		loadStringEx(stringID:String, languageCode:String):String [statik] Belirli bir dize kimliği ve dil koduyla ilişkilendirilmiş dize değerini döndürür.	Locale
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void EventDispatcher nesnesinden bir dinleyiciyi kaldırır.	EventDispatcher
		setDefaultLang(langCode:String):void [statik] Varsayılan dil kodunu ayarlar.	Locale
		setLoadCallback(loadCallback:Function):* [statik] XML dosyası yüklendikten sonra çağrılan geri çağırma işlevini ayarlar.	Locale
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		setString(stringID:String, languageCode:String, stringValue:String):void [statik] Belirli bir dize kimliği ve dil kodunun yeni dize değerini ayarlar.	Locale
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String Belirtilen nesnenin dize olarak temsil edilen halini döndürür.	Object
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object
		willTrigger(type:String):Boolean 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

Olaylar

Olaylarla ilgili daha fazla bilgi için tıklatın

Miras Alınan Olayları Gizle

Miras Alınan Olayları Göster

	Olay		Özet	Tanımlayan:
		activate	[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir.	EventDispatcher
		deactivate	[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir.	EventDispatcher

Özellik Ayrıntısı

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? )

Aşağıdaki örnekte, Sahne Alanı'ndaki dinamik olarak oluşturulmuş 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? )

Aşağıdaki örnek, bir ComboBox bileşeninin geçerli değerini temel alan bir dil XML dosyası yükler. Bir ComboBox bileşenini Sahne Alanı'na sürükleyin ve bileşene 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? )

Aşağıdaki örnek, geçerli olarak yüklü olan dil XML dosyası için 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
     }

Yöntem Ayrıntısı

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.

Döndürür

*

Örnek ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnekte, Sahne Alanı'ndaki bir metin alanını İngilizce XML dil dosyasındaki 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? )

Aşağıdaki örnek, Flash Player'a çalışma dizininize göre İngilizce ("en") çevirilerin "locale/locale_en.xml" dosyasında bulunduğunu ve Fransızca ("fr") çevirilerin "locale/locale_fr.xml" dosyasında olduğunu bildirir (örnek ve açıklamalar Chris Inch tarafından http://www.chrisinch.com adresinde sağlanmıştı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.

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? )

Aşağıdaki örnekte, her 10 milisaniyede bir dil dosyasının başarıyla yüklenip yüklenmediğini denetlemek için bir aralık kullanılmaktadır. XML dosyası yüklendikten sonra Sahne Alanı'ndaki 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.

Döndürür

String — Varsayılan dil kodunu döndürür.

İlgili API Öğeleri

Locale.setDefaultLang()

Örnek ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnek, Flash belgesi için ilk varsayılan dili barındırmak için kullanılan 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? )

Bu örnekte, Sahne Alanı'ndaki 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? )

Aşağıdaki örnekte, İngilizce (en) XML dil dosyasını yüklemek için 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ı.

Döndürür

String — Geçerli dildeki belirli bir dize kimliğiyle ilişkilendirilmiş dize değeri.

İlgili API Öğeleri

Locale.loadStringEx()

Örnek ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnekte, her 10 milisaniyede bir dil dosyasının başarıyla yüklenip yüklenmediğini denetlemek için bir aralık kullanılmaktadır. XML dosyası yüklendikten sonra Sahne Alanı'ndaki 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.

Döndürür

String — languageCode parametresi tarafından belirtilen dildeki belirli bir dize kimliğiyle ilişkilendirilmiş dize değeri.

İlgili API Öğeleri

Locale.loadString()

Örnek ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnekte, geçerli olarak yüklü olan Fransızca dil XML dosyasına yönelik 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

Locale.getDefaultLang()

Örnek ( Bu örnek nasıl kullanılır? )

     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.

Döndürür

*

Örnek ( Bu örnek nasıl kullanılır? )

Aşağıdaki örnekte, her 10 milisaniyede bir dil dosyasının başarıyla yüklenip yüklenmediğini denetlemek için bir aralık kullanılmaktadır. XML dosyası yüklendikten sonra Sahne Alanı'ndaki 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? )

Aşağıdaki örnekte, İngilizce (en) ve Fransızca (fr) için IDS_WELCOMEdizesini 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

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

Locale - AS3 Flash

Paketlerx

Dil Öğeleri

Ekler

Paket fl.lang

autoReplace

languageCodeArray

stringIDArray

addDelayedInstance

addXMLPath

checkXMLStatus

getDefaultLang

initialize

loadLanguageXML

loadString

loadStringEx

setDefaultLang

setLoadCallback

setString