Locale - Adobe ActionScript® 3 (AS3 Flash) — dokumentacja interfejsu API

Pakiet	fl.lang
Klasa	public class Locale
Dziedziczenie	Locale EventDispatcher Object

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Klasa fl.lang.Locale pozwala kontrolować sposób wyświetlania tekstów wielojęzycznych w plikach SWF. Panel Ciągi w programie Flash Strings umożliwia używanie identyfikatorów ciągów znaków zamiast literalnych ciągów w polach tekstowych. W ten sposób można utworzyć plik SWF wyświetlający teksty załadowane z pliku XML właściwego dla konkretnego języka. Plik XML musi być plikiem w formacie XML Localization Interchange File Format (XLIFF). Istnieje kilka sposobów wyświetlania ciągów charakterystycznych dla języka zawartych w plikach XLIFF:

„automatycznie w czasie wykonania” — program Flash Player zastępuje identyfikatory ciągów ciągami z pliku XML dla języka zgodnego z domyślnym językiem systemowym zwróconym przez właściwość flash.system.capabilities.language.
„ręcznie, używając stołu montażowego” — identyfikatory ciągów są zastępowane ciągami znaków w czasie kompilacji i nie mogą być zmienione przez program Flash Player.
„przez ActionScript w czasie wykonania” — zastępowaniem identyfikatorów ciągów steruje kod ActionScript w czasie wykonywania. Ta opcja zapewnia kontrolę zarówno nad czasem zastępowania identyfikatorów, jak i nad wyborem języka.

Właściwości i metod tej klasy można używać, gdy identyfikatory ciągów znaków mają być zastępowane zgodnie z ustawieniem "via ActionScript at runtime".

Wszystkie dostępne właściwości i metody są statyczne, co oznacza, że są dostępne bezpośrednio z klasy fl.lang.Locale, a nie za pośrednictwem instancji tej klasy.

Uwaga: Klasa Locale jest instalowana w ścieżce klas narzędzia Flash Authoring i jest automatycznie kompilowana do plików SWF użytkownika. Stosowanie klasy Locale powoduje zwiększenie rozmiaru pliku SWF, ponieważ klasa ta jest umieszczana w pliku podczas kompilacji.

Powiązane elementy interfejsu API

flash.system.Capabilities.language

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		autoReplace : Boolean [statyczny] Określa, czy po wczytaniu pliku XML ciągi znaków mają być automatycznie zastępowane.	Locale
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object
		languageCodeArray : Array [statyczny] [tylko do odczytu] Tablica kodów języków, które zostały już określone lub wczytane do pliku FLA.	Locale
		stringIDArray : Array [statyczny] [tylko do odczytu] Tablica zawierająca wszystkie identyfikatory ciągów z pliku FLA.	Locale

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		addDelayedInstance(instance:Object, stringID:String):* [statyczny] Dodaje parę {instancja, identyfikator ciągu} do tablicy wewnętrznej, która będzie używana później.	Locale
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu.	EventDispatcher
		addXMLPath(langCode:String, path:String):void [statyczny] Dodaje parę {kodJęzyka, ścieżkaJęzyka} do tablicy wewnętrznej, która będzie używana później.	Locale
		checkXMLStatus():Boolean [statyczny] Zwraca prawdę, gdy kod XML został wczytany, a w przeciwnym razie fałsz.	Locale
		dispatchEvent(event:Event):Boolean Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń.	EventDispatcher
		getDefaultLang():String [statyczny] Kod domyślnego języka — określony w oknie dialogowym panelu Ciągi znaków lub za pomocą metody setDefaultLang().	Locale
		hasEventListener(type:String):Boolean Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń.	EventDispatcher
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		initialize():void [statyczny] Automatycznie wybiera język oraz wczytuje plik XML języka.	Locale
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		loadLanguageXML(xmlLanguageCode:String, customXmlCompleteCallback:Function = null):void [statyczny] Wczytuje wskazany plik językowy XML.	Locale
		loadString(id:String):String [statyczny] Zwraca wartość ciągu skojarzoną z zadanym identyfikatorem ciągu w bieżącym języku.	Locale
		loadStringEx(stringID:String, languageCode:String):String [statyczny] Zwraca wartość ciągu skojarzoną z zadanym identyfikatorem ciągu i kodem języka.	Locale
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Usuwa detektor z obiektu EventDispatcher.	EventDispatcher
		setDefaultLang(langCode:String):void [statyczny] Ustawia kod domyślnego języka.	Locale
		setLoadCallback(loadCallback:Function):* [statyczny] Ustawia funkcję wywołania zwrotnego, która będzie wywoływana po wczytaniu pliku XML.	Locale
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		setString(stringID:String, languageCode:String, stringValue:String):void [statyczny] Zwraca nową wartość identyfikatora ciągu i kodu języka.	Locale
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toString():String Zwraca ciąg reprezentujący określony obiekt.	Object
		valueOf():Object Zwraca pierwotną wartość dla określonego obiektu.	Object
		willTrigger(type:String):Boolean Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych.	EventDispatcher

Zdarzenia

Kliknij, aby uzyskać więcej informacji o zdarzeniach

Ukryj zdarzenia dziedziczone

Pokaż zdarzenia dziedziczone

	Zdarzenie		Podsumowanie	Zdefiniowane przez
		activate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny.	EventDispatcher
		deactivate	[zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny.	EventDispatcher

Szczegół właściwości

autoReplace

właściwość

autoReplace:Boolean

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Określa, czy po wczytaniu pliku XML ciągi znaków mają być automatycznie zastępowane. Wartość true powoduje wybranie metody zastępowania ciągów równoważnej opcji „automatycznie w czasie wykonania” w panelu Ciągi. Oznacza to, że program Flash Player określi domyślny język środowiska hosta i automatycznie będzie wyświetlał tekst w tym języku. Wartość false powoduje wybranie metody zastępowania ciągów równoważnej opcji „przez ActionScript w czasie wykonania” w panelu Ciągi. Oznacza to, że program użytkownika odpowiada za załadowanie odpowiedniego pliku XML z tekstami.

Wartość domyślna tej właściwości odzwierciedla opcję zastępowania ciągów wybrane w oknie dialogowym panelu Ciągi: true w przypadku "automatically at runtime" (ustawienie domyślne) lub false w przypadku "via ActionScript at runtime".

Implementacja
public static function get autoReplace():Boolean
public static function set autoReplace(value:Boolean):void

Przykład ( Sposób korzystania z tego przykładu )

W poniższym przykładzie użyto właściwości Locale.autoReplace do zapełnienia dynamicznie utworzonego pola tekstowego greeting_txt na stole montażowym zawartością ciągu znaków IDS_GREETING z pliku XML języka angielskiego. W panelu Ciągi klikamy przycisk Ustawienia, aby otworzyć okno dialogowe Ustawienia. W oknie dialogowym Ustawienia możemy dodać dwa aktywne języki: angielski (en) i francuski (fr), wybrać opcję zastępowania „przez ActionScript w czasie wykonywania” i kliknąć OK. Na koniec w panelu Ciągi wprowadzamy identyfikator ciągu IDS_GREETING i dodajemy tekst dla każdego z aktywnych języków.

     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

właściwość

languageCodeArray:Array [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Tablica kodów języków, które zostały już określone lub wczytane do pliku FLA. Kody języków nie są posortowane alfabetycznie.

Implementacja
public static function get languageCodeArray():Array

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje ładowanie pliku językowego XML na podstawie bieżącej wartości składnika ComboBox. Przeciągamy składnik ComboBox na stół montażowy i nadajemy mu nazwę instancji lang_cb. Za pomocą narzędzia Tekst tworzymy dynamiczne pole tekstowe i nadajemy mu nazwę instancji greeting_txt. W panelu Ciągi dodajemy co najmniej dwa aktywne języki, ustawiamy opcję zastępowania ciągów na „przez ActionScript w czasie wykonania” i klikamy przycisk OK. Następnie dodajemy identyfikator ciągu IDS_GREETING i wprowadzamy tekst dla każdego z aktywnych języków. Na koniec dodajemy następujący kod ActionScript do 1. klatki głównej osi czasu:

     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

właściwość

stringIDArray:Array [tylko do odczytu]

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Tablica zawierająca wszystkie identyfikatory ciągów z pliku FLA. Identyfikatory ciągów nie są posortowane alfabetycznie.

Implementacja
public static function get stringIDArray():Array

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje odczytanie właściwości Locale.stringIDArray dla załadowanego pliku językowego XML. Klikamy przycisk Ustawienia w panelu Ciągi, aby otworzyć okno dialogowe Ustawienia. Następnie dodajemy dwa aktywne języki: angielski (en) i francuski (fr), ustawiamy przycisk opcji zastępowania ciągów na „przez ActionScript w czasie wykonania” i klikamy przycisk OK. W panelu Ciągi dodajemy identyfikator ciągu IDS_GREETING, a następnie tekst dla każdego z aktywnych języków.

     Locale.setLoadCallback(localeCallback);
     Locale.loadLanguageXML("fr");
     function localeCallback(success:Boolean) {
      trace(success);
      trace(Locale.stringIDArray); // IDS_GREETING
      trace(Locale.loadStringEx("IDS_GREETING", "fr")); // bonjour
     }

Szczegół metody

addDelayedInstance

()

metoda

public static function addDelayedInstance(instance:Object, stringID:String):*

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Dodaje parę {instancja, identyfikator ciągu} do tablicy wewnętrznej, która będzie używana później. Ta metoda jest używana przede wszystkim w programie Flash, gdy wybraną metodą zastępowania ciągów jest „automatycznie w czasie wykonania”.

Parametry

	`instance:Object` — Nazwa instancji pola tekstowego, które należy zapełnić.

	`stringID:String` — Identyfikator ciągu znaków w danym języku.

Zwraca

*

Przykład ( Sposób korzystania z tego przykładu )

W poniższym przykładzie zastosowano właściwość autoReplace i metodę addDelayedInstance() do zapełnienia pola tekstowego na stole montażowym ciągiem IDS_GREETING z pliku XML języka angielskiego.

     greeting_txt.autoSize = TextFieldAutoSize.LEFT;
     Locale.autoReplace = true;
     Locale.addDelayedInstance(greeting_txt, "IDS_GREETING");
     Locale.loadLanguageXML("en");

addXMLPath

()

metoda

public static function addXMLPath(langCode:String, path:String):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Dodaje parę {kodJęzyka, ścieżkaJęzyka} do tablicy wewnętrznej, która będzie używana później. Ta metoda jest używana przede wszystkim w programie Flash Player, gdy wybraną metodą zastępowania ciągów jest „automatycznie w czasie wykonania” lub „przez ActionScript w czasie wykonania”. Ta metoda umożliwia ładowanie plików języka Flash Professional z niestandardowej lokalizacji zamiast domyślnej lokalizacji skonfigurowane w Flash Professional. Domyślnie Flash Professional tworzy plik XML dla każdego języka w katalogu roboczym, w podkatalogu nazwanym, tak samo jak plik FLA.

Parametry

	`langCode:String` — Kod języka.

	`path:String` — Ścieżka XML, która ma być dodana.

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład informuje program Flash Player o tym, że tłumaczenia angielskie („en”) są dostępne w pliku „locale/locale_en.xml”, a francuskie („fr”) w pliku „locale/locale_fr.xml” (względem katalogu roboczego) (autorem przykładu i opisu jest Chris Inch, adres witryny: http://www.chrisinch.com):

     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

()

metoda

public static function checkXMLStatus():Boolean

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Zwraca wartość true, jeśli plik XML został załadowany; false w przeciwnym razie.

Zwraca

Boolean — Zwraca wartość true, jeśli plik XML został wczytany; false w przeciwnym razie.

Przykład ( Sposób korzystania z tego przykładu )

W poniższym przykładzie co 10 milisekund następuje sprawdzenie, czy plik językowy został pomyślnie wczytany. Po załadowaniu pliku XML instancja pola tekstowego greeting_txt na stole montażowym jest zapełniana ciągiem IDS_GREETING z pliku językowego XML.

     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

()

metoda

public static function getDefaultLang():String

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Kod domyślnego języka — określony w oknie dialogowym panelu Ciągi lub za pomocą metody setDefaultLang.

Zwraca

String — Zwraca kod domyślnego języka.

Powiązane elementy interfejsu API

Locale.setDefaultLang()

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje tworzenie zmiennej o nazwie defLang, służącej do przechowywania początkowego domyślnego języka dla dokumentu Flash. Klikamy przycisk Ustawienia w panelu Ciągi, aby otworzyć okno dialogowe Ustawienia. Następnie dodajemy dwa aktywne języki: angielski (en) i francuski (fr), ustawiamy przycisk opcji zastępowania ciągów na „przez ActionScript w czasie wykonania” i klikamy przycisk OK. W panelu Ciągi dodawany jest identyfikator ciągu IDS_GREETING, a następnie tekst dla każdego z aktywnych języków.

     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

()

metoda

public static function initialize():void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Automatycznie wybiera język oraz wczytuje plik XML języka. Ta metoda jest używana przede wszystkim w programie Flash, gdy wybraną metodą zastępowania ciągów jest „automatycznie w czasie wykonania”.

Przykład ( Sposób korzystania z tego przykładu )

Ten przykład ilustruje użycie metody initialize() do automatycznego zapełnienia pola tekstowego greeting_txt na stole montażowym tekstem w bieżącym języku systemu operacyjnego. Zamiast używać bezpośrednio metody initialize(), należy wybrać metodę zastępowania ciągów automatycznie w czasie wykonania”.

     trace(System.capabilities.language);
     Locale.autoReplace = true;
     Locale.addDelayedInstance(greeting_txt, "IDS_GREETING");
     Locale.initialize();

loadLanguageXML

()

metoda

public static function loadLanguageXML(xmlLanguageCode:String, customXmlCompleteCallback:Function = null):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Wczytuje wskazany plik językowy XML.

Parametry

	`xmlLanguageCode:String` — Kod języka dla pliku językowego XML, który ma zostać załadowany.

	`customXmlCompleteCallback:Function` (default = `null`) — Niestandardowa funkcja wywołania zwrotnego, którą należy wywołać po załadowaniu pliku językowego XML.

Przykład ( Sposób korzystania z tego przykładu )

W poniższym przykładzie użyto metody loadLanguageXML() w celu zładowania pliku XML języka angielskiego (en). Po załadowaniu pliku językowego wywoływana jest metoda localeCallback(), która zapełnia pole tekstowe greeting_txt na stole montażowym zawartością ciągu IDS_GREETING z pliku XML.

     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

()

metoda

public static function loadString(id:String):String

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Zwraca wartość ciągu skojarzoną z zadanym identyfikatorem ciągu w bieżącym języku.

Parametry

id:String — Numer identyfikacyjny ciągu do wczytania.

Zwraca

String — Wartość ciągu znaków skojarzona z danym identyfikatorem ciągu w bieżącym języku.

Powiązane elementy interfejsu API

Locale.loadStringEx()

Przykład ( Sposób korzystania z tego przykładu )

W poniższym przykładzie co 10 milisekund następuje sprawdzenie, czy plik językowy został pomyślnie załadowany. Po załadowaniu pliku XML instancja pola tekstowego greeting_txt na stole montażowym jest zapełniana ciągiem IDS_GREETING z pliku językowego XML.

     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

()

metoda

public static function loadStringEx(stringID:String, languageCode:String):String

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Zwraca wartość ciągu skojarzoną z zadanym identyfikatorem ciągu i kodem języka. Aby uniknąć nieoczekiwanego załadowania pliku XML, metoda loadStringEx() nie ładuje pliku XML języka, jeśli plik XML nie jest jeszcze załadowany. W odpowiednim czasie należy wywołać metodę loadLanguageXML(), aby załadować plik językowy XML.

Parametry

	`stringID:String` — Numer identyfikacyjny ciągu do załadowania.

	`languageCode:String` — Kod języka.

Zwraca

String — Wartość ciągu znaków skojarzona z bieżącym identyfikatorem ciągu w języku określonym parametrem languageCode.

Powiązane elementy interfejsu API

Locale.loadString()

Przykład ( Sposób korzystania z tego przykładu )

W poniższym przykładzie zastosowano metodę loadStringEx() do określenia wartości IDS_GREETING z załadowanego obecnie pliku XML języka francuskiego.

     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

()

metoda

public static function setDefaultLang(langCode:String):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Ustawia kod domyślnego języka.

Parametry

langCode:String — Ciąg znaków reprezentujący kod języka.

Powiązane elementy interfejsu API

Locale.getDefaultLang()

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje tworzenie zmiennej o nazwie defLang służącej do przechowywania początkowego domyślnego języka dla dokumentu Flash. Klikamy przycisk Ustawienia w panelu Ciągi, aby otworzyć okno dialogowe Ustawienia. Następnie dodajemy dwa aktywne języki: angielski (en) i francuski (fr), ustawiamy przycisk opcji zastępowania ciągów na „przez ActionScript w czasie wykonania” i klikamy przycisk OK. W panelu Ciągi dodawany jest identyfikator ciągu IDS_GREETING, a następnie tekst dla każdego z aktywnych języków.

     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

()

metoda

public static function setLoadCallback(loadCallback:Function):*

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Ustawia funkcję wywołania zwrotnego, która będzie wywoływana po wczytaniu pliku XML.

Parametry

loadCallback:Function — Funkcja, która ma być wywoływana po załadowaniu pliku XML.

Zwraca

*

Przykład ( Sposób korzystania z tego przykładu )

     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

()

metoda

public static function setString(stringID:String, languageCode:String, stringValue:String):void

Wersja języka:

ActionScript 3.0

Wersja produktu:

Flash CS3

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0

Zwraca nową wartość identyfikatora ciągu i kodu języka.

Parametry

	`stringID:String` — Numer identyfikacyjny ciągu do ustawienia.

	`languageCode:String` — Kod języka.

	`stringValue:String` — Wartość ciągu znaków.

Przykład ( Sposób korzystania z tego przykładu )

W poniższym przykładzie zastosowano metodę setString() do ustawienia ciągu znaków IDS_WELCOME dla języka angielskiego (en) i francuskiego (fr).

     Locale.setString("IDS_WELCOME", "en", "hello");
     Locale.setString("IDS_WELCOME", "fr", "bonjour");
     trace(Locale.loadStringEx("IDS_WELCOME", "en")); // hello

Informacje prawne | Zasady prywatności online

Locale - AS3 Flash

Pakietyx

Elementy językowe

Dodatki

Pakiet fl.lang

autoReplace

languageCodeArray

stringIDArray

addDelayedInstance

addXMLPath

checkXMLStatus

getDefaultLang

initialize

loadLanguageXML

loadString

loadStringEx

setDefaultLang

setLoadCallback

setString