| 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):voidPrzykł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():ArrayPrzykł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():ArrayPrzykł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
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne