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 |
-
„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
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 |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
[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 | ||
[statyczny]
Dodaje parę {kodJęzyka, ścieżkaJęzyka} do tablicy wewnętrznej, która będzie używana później. | Locale | ||
[statyczny]
Zwraca prawdę, gdy kod XML został wczytany, a w przeciwnym razie fałsz. | Locale | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
[statyczny]
Kod domyślnego języka — określony w oknie dialogowym panelu Ciągi znaków lub za pomocą metody setDefaultLang(). | Locale | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
[statyczny]
Automatycznie wybiera język oraz wczytuje plik XML języka. | Locale | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
[statyczny]
Wczytuje wskazany plik językowy XML. | Locale | ||
[statyczny]
Zwraca wartość ciągu skojarzoną z zadanym identyfikatorem ciągu w bieżącym języku. | Locale | ||
[statyczny]
Zwraca wartość ciągu skojarzoną z zadanym identyfikatorem ciągu i kodem języka. | Locale | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
[statyczny]
Ustawia kod domyślnego języka. | Locale | ||
[statyczny]
Ustawia funkcję wywołania zwrotnego, która będzie wywoływana po wczytaniu pliku XML. | Locale | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
[statyczny]
Zwraca nową wartość identyfikatora ciągu i kodu języka. | Locale | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher |
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 )
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 )
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 )
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 }
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.
|
* |
Przykład ( Sposób korzystania z tego przykładu )
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 )
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.
Boolean — Zwraca wartość true , jeśli plik XML został wczytany; false w przeciwnym razie.
|
Przykład ( Sposób korzystania z tego przykładu )
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
.
String — Zwraca kod domyślnego języka.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
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 )
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 )
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.
|
String — Wartość ciągu znaków skojarzona z danym identyfikatorem ciągu w bieżącym języku.
|
Powiązane elementy interfejsu API
Przykład ( Sposób korzystania z tego przykładu )
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.
|
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
Przykład ( Sposób korzystania z tego przykładu )
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
Przykład ( Sposób korzystania z tego przykładu )
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.
|
* |
Przykład ( Sposób korzystania z tego przykładu )
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"); }
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 )
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
Tue Jun 12 2018, 12:06 PM Z