Pakket | fl.lang |
Klasse | public class Locale |
Overerving | Locale EventDispatcher Object |
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
-
automatisch bij uitvoering
— Flash Player vervangt tekenreeks-id's door tekenreeksen uit het XML-bestand die overeenkomen met de standaardsysteemtaalcode die door flash.system.capabilities.language wordt geretourneerd. -
handmatig met werkgebiedtaal
— Tekenreeks-id's worden bij compilatie vervangen door tekenreeksen en kunnen niet door Flash Player worden gewijzigd. -
via ActionScript bij uitvoering
— De vervanging van tekenreeks-id's wordt met ActionScript bij uitvoering beheerd. Met deze optie hebt u controle over zowel de timing als de taal van de vervanging van tekenreeks-id's.
U kunt de eigenschappen en methoden van deze klasse gebruiken wanneer u de tekenreeks-id's 'via ActionScript at runtime' wilt vervangen.
Alle beschikbare eigenschappen en methoden zijn statisch, dit houdt in dat deze bereikbaar zijn via de klasse fl.lang.Locale zelf in plaats van via een instantie van de klasse.
Opmerking: de klasse Locale is geïnstalleerd in het klassepad voor Flash-ontwerp en wordt automatisch gecompileerd in de SWF-bestanden. Door de klasse Locale te gebruiken, neemt de grootte van het SWF-bestand iets toe aangezien de klasse in het SWF-bestand wordt gecompileerd.
Verwante API-elementen
Eigenschap | Gedefinieerd door | ||
---|---|---|---|
autoReplace : Boolean [statisch]
Hiermee wordt bepaald of tekenreeksen automatisch worden vervangen nadat het XML-bestand is geladen. | Locale | ||
constructor : Object
Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie. | Object | ||
languageCodeArray : Array [statisch] [alleen-lezen]
Een array van taalcodes voor de talen die in het FLA-bestand zijn opgegeven of geladen. | Locale | ||
stringIDArray : Array [statisch] [alleen-lezen]
Een array van alle tekenreeks-id's in het FLA-bestand. | Locale |
Methode | Gedefinieerd door | ||
---|---|---|---|
[statisch]
Hiermee wordt het paar instantie en tekenreeks-id toegevoegd aan de interne array voor toekomstig gebruik. | Locale | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registreert een gebeurtenislistenerobject bij een object EventDispatcher, zodat de listener een melding van een gebeurtenis ontvangt. | EventDispatcher | ||
[statisch]
Hiermee wordt het paar languageCode en languagePath toegevoegd aan de interne array voor toekomstig gebruik. | Locale | ||
[statisch]
Hiermee wordt true geretourneerd als het XML-bestand is geladen; anders false. | Locale | ||
Verzendt een gebeurtenis naar de gebeurtenisstroom. | EventDispatcher | ||
[statisch]
De standaardtaalcode zoals ingesteld in het dialoogvenster van het deelvenster Tekenreeksen of door het aanroepen van methode setDefaultLang(). | Locale | ||
Controleert of het object EventDispatcher listeners heeft geregistreerd voor een specifiek type gebeurtenis. | EventDispatcher | ||
Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd. | Object | ||
[statisch]
Hiermee wordt automatisch de taal bepaald die moet worden gebruikt en wordt het XML-taalbestand geladen. | Locale | ||
Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven. | Object | ||
[statisch]
Hiermee wordt het opgegeven XML-taalbestand geladen. | Locale | ||
[statisch]
Retourneert de tekenreekswaarde die aan de opgegeven tekenreeks-id in de huidige taal is gekoppeld. | Locale | ||
[statisch]
Retourneert de tekenreekswaarde die aan de opgegeven tekenreeks-id en taalcode is gekoppeld. | Locale | ||
Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd. | Object | ||
Verwijdert een listener uit het object EventDispatcher. | EventDispatcher | ||
[statisch]
Hiermee wordt de standaardtaalcode ingesteld. | Locale | ||
[statisch]
Hiermee wordt de callback-functie ingesteld die wordt aangeroepen nadat het XML-bestand is geladen. | Locale | ||
Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in. | Object | ||
[statisch]
Hiermee wordt de nieuwe tekenreekswaarde van een opgegeven tekenreeks-id en taalcode ingesteld. | Locale | ||
Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies. | Object | ||
Retourneert een tekenreeksrepresentatie van het opgegeven object. | Object | ||
Retourneert de primitieve waarde van het opgegeven object. | Object | ||
Controleert of een gebeurtenislistener is geregistreerd bij dit object EventDispatcher of een van de voorouders voor het opgegeven type gebeurtenis. | EventDispatcher |
autoReplace | eigenschap |
autoReplace:Boolean
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Hiermee wordt bepaald of tekenreeksen automatisch worden vervangen nadat het XML-bestand is geladen. Wanneer deze op true
is ingesteld, komt de methode voor het vervangen van de tekst overeen met de instelling automatisch bij uitvoering
in het deelvenster Tekenreeksen. Dit houdt in dat Flash Player de standaardtaal van de hostomgeving bepaalt en de tekst automatisch in die taal weergeeft. Wanneer deze is ingesteld op false
, komt de methode voor het vervangen van tekst overeen met de instelling via ActionScript bij uitvoering
in het deelvenster Tekenreeksen. Dit betekent dat u verantwoordelijk bent voor het laden van het geschikte XML-bestand om de tekst weer te geven.
De standaardwaarde van deze eigenschap weerspiegelt de instelling die u selecteert bij Tekenreeksen vervangen in het dialoogvenster Tekenreeksen: true
voor automatisch bij uitvoering
(de standaardinstelling) en false
voor 'via ActionScript bij uitvoering'.
Implementatie
public static function get autoReplace():Boolean
public static function set autoReplace(value:Boolean):void
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Locale.autoReplace
gebruikt om het dynamisch gemaakte tekstveld greeting_txt
in het werkgebied te vullen met de inhoud van de tekenreeks IDS_GREETING
in het Engelse XML-bestand. Klik op de knop Instellingen in het deelvenster Tekenreeksen om het dialoogvenster Instellingen te openen. U kunt via het dialoogvenster Instellingen twee actieve talen toevoegen: Engels (en) en Frans (fr). Stel het keuzerondje Tekenreeksen vervangen in op via ActionScript bij uitvoering
en klik vervolgens op OK. Voer in het deelvenster Tekenreeksen de tekenreeks-id IDS_GREETING in en voeg tekst toe voor elke actieve taal.
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 | eigenschap |
languageCodeArray:Array
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Een array van taalcodes voor de talen die in het FLA-bestand zijn opgegeven of geladen. De taalcodes worden niet in alfabetische volgorde gesorteerd.
Implementatie
public static function get languageCodeArray():Array
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
lang_cb
. Maak een dynamisch tekstveld met het gereedschap Tekst en geef het de instantienaam greeting_txt
. Voeg in het deelvenster Tekenreeksen ten minste twee actieve talen toe, stel het keuzerondje Tekenreeksen vervangen in op via ActionScript bij uitvoering
en klik op OK. Voeg vervolgens de tekenreeks-id IDS_GREETING toe en voer tekst in voor elke actieve taal. Voeg de volgende ActionScript-code toe aan frame 1 van de hoofdtijdlijn:
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 | eigenschap |
stringIDArray:Array
[alleen-lezen] Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Een array van alle tekenreeks-id's in het FLA-bestand. De tekenreeks-id's worden niet in alfabetische volgorde gesorteerd.
Implementatie
public static function get stringIDArray():Array
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
Locale.stringIDArray
voor het momenteel geladen XML-taalbestand getraceerd. Klik op de knop Instellingen in het deelvenster Tekenreeksen om het dialoogvenster Instellingen te openen. Voeg vervolgens twee actieve talen toe: Engels (en) en Frans (fr). Stel het keuzerondje Tekenreeksen vervangen in op via ActionScript bij uitvoering
en klik vervolgens op OK. Voeg in het deelvenster Tekenreeksen de tekenreeks-id IDS_GREETING toe en voeg vervolgens tekst toe voor elke actieve taal.
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 | () | methode |
public static function addDelayedInstance(instance:Object, stringID:String):*
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Hiermee wordt het paar instantie en tekenreeks-id toegevoegd aan de interne array voor toekomstig gebruik. Deze wordt met name door Flash gebruikt wanneer de methode voor het vervangen van tekenreeksen automatisch bij uitvoering
is.
Parameters
instance:Object — Instantienaam van het tekstveld dat moet worden gevuld.
| |
stringID:String — Een tekenreeks-id van de taal.
|
* |
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
autoReplace
en de methode addDelayedInstance()
gebruikt om een tekstveld in het werkgebied te vullen met de tekenreeks IDS_GREETING
uit het Engelse XML-taalbestand.
greeting_txt.autoSize = TextFieldAutoSize.LEFT; Locale.autoReplace = true; Locale.addDelayedInstance(greeting_txt, "IDS_GREETING"); Locale.loadLanguageXML("en");
addXMLPath | () | methode |
public static function addXMLPath(langCode:String, path:String):void
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Hiermee wordt het paar languageCode en languagePath toegevoegd aan de interne array voor toekomstig gebruik. Deze wordt met name door Flash Player gebruikt wanneer de methode voor het vervangen van tekenreeksen automatisch bij uitvoering
of via ActionScript bij uitvoering
is. Met deze methode kunt u XML-bestanden laden van een aangepaste locatie in plaats van de standaardlocatie die is ingesteld door Flash Professional. Flash Professional maakt standaard een XML-bestand voor elke taal in uw werkmap onder een submap met de naam van uw FLA-bestand.
Parameters
langCode:String — De taalcode.
| |
path:String — Het XML-pad dat moet worden toegevoegd.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
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 | () | methode |
public static function checkXMLStatus():Boolean
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Hiermee wordt true
geretourneerd als het XML-bestand is geladen; anders false
.
Boolean — Hiermee wordt true geretourneerd als het XML-bestand is geladen; anders false .
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
greeting_txt
in het werkgebied gevuld met de tekenreeks IDS_GREETING
uit het XML-taalbestand.
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 | () | methode |
public static function getDefaultLang():String
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
De standaardtaalcode zoals ingesteld in het dialoogvenster van het deelvenster Tekenreeksen of door het aanroepen van methode setDefaultLang()
.
String — Retourneert de standaardtaalcode.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
defLang
gemaakt. Deze bevat de initiële standaardtaal voor het Flash-document. Klik op de knop Instellingen in het deelvenster Tekenreeksen om het dialoogvenster Instellingen te openen. Voeg vervolgens twee actieve talen toe: Engels (en) en Frans (fr). Stel het keuzerondje Tekenreeksen vervangen in op via ActionScript bij uitvoering
en klik vervolgens op OK. Voeg in het deelvenster Tekenreeksen de tekenreeks-id IDS_GREETING toe en voeg vervolgens tekst toe voor elke actieve taal.
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 | () | methode |
public static function initialize():void
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Hiermee wordt automatisch de taal bepaald die moet worden gebruikt en wordt het XML-taalbestand geladen. Deze wordt met name door Flash gebruikt wanneer de methode voor het vervangen van tekenreeksen automatisch bij uitvoering
is.
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
initialize()
moet worden gebruikt om automatisch het tekstveld greeting_txt
in het werkgebied te vullen met de huidige OS-taal van de gebruiker. Gebruik de methode automatisch bij uitvoering
voor het vervangen van tekenreeksen in plaats van rechtstreeks de methode initialize()
.
trace(System.capabilities.language); Locale.autoReplace = true; Locale.addDelayedInstance(greeting_txt, "IDS_GREETING"); Locale.initialize();
loadLanguageXML | () | methode |
public static function loadLanguageXML(xmlLanguageCode:String, customXmlCompleteCallback:Function = null):void
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Hiermee wordt het opgegeven XML-taalbestand geladen.
Parameters
xmlLanguageCode:String — De taalcode voor het XML-taalbestand dat u wilt laden.
| |
customXmlCompleteCallback:Function (default = null ) — Aangepaste callback-functie die moet worden aangeroepen wanneer het XML-taalbestand wordt geladen.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
loadLanguageXML()
gebruikt om het Engelse (en) XML-taalbestand te laden. Wanneer het taalbestand is geladen, wordt de methode localeCallback()
aangeroepen en wordt het tekstveld greeting_txt
in het werkgebied gevuld met de inhoud van de tekenreeks IDS_GREETING
in het XML-bestand.
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 | () | methode |
public static function loadString(id:String):String
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Retourneert de tekenreekswaarde die aan de opgegeven tekenreeks-id in de huidige taal is gekoppeld.
Parameters
id:String — Het identificatienummer (id) van de tekenreeks die moet worden geladen.
|
String — De tekenreekswaarde die aan de opgegeven tekenreeks-id in de huidige taal is gekoppeld.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
greeting_txt
in het werkgebied gevuld met de tekenreeks IDS_GREETING
uit het XML-taalbestand.
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 | () | methode |
public static function loadStringEx(stringID:String, languageCode:String):String
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Retourneert de tekenreekswaarde die aan de opgegeven tekenreeks-id en taalcode is gekoppeld. loadStringEx()
laadt het XML-taalbestand niet wanneer het XML-bestand nog niet is geladen om het onverwacht laden van een XML-bestand te vermijden. U moet op het juiste tijdstip besluiten de methode loadLanguageXML()
aan te roepen wanneer u een XML-taalbestand wilt laden.
Parameters
stringID:String — Het identificatienummer (id) van de tekenreeks die moet worden geladen.
| |
languageCode:String — De taalcode.
|
String — De tekenreekswaarde die is gekoppeld aan de opgegeven tekenreeks-id in de taal die door de parameter languageCode is opgegeven.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
loadStringEx()
gebruikt om de waarde van de tekenreeks IDS_GREETING
te traceren voor het momenteel geladen Franse XML-taalbestand.
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 | () | methode |
public static function setDefaultLang(langCode:String):void
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Hiermee wordt de standaardtaalcode ingesteld.
Parameters
langCode:String — Een tekenreeks die een taalcode vertegenwoordigt.
|
Verwante API-elementen
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
defLang
gemaakt. Deze bevat de initiële standaardtaal voor het Flash-document. Klik op de knop Instellingen in het deelvenster Tekenreeksen om het dialoogvenster Instellingen te openen. Voeg vervolgens twee actieve talen toe: Engels (en) en Frans (fr). Stel het keuzerondje Tekenreeksen vervangen in op via ActionScript bij uitvoering
en klik vervolgens op OK. Voeg in het deelvenster Tekenreeksen de tekenreeks-id IDS_GREETING toe en voeg vervolgens tekst toe voor elke actieve taal.
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 | () | methode |
public static function setLoadCallback(loadCallback:Function):*
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Hiermee wordt de callback-functie ingesteld die wordt aangeroepen nadat het XML-bestand is geladen.
Parameters
loadCallback:Function — De functie die moet worden aangeroepen wanneer het XML-taalbestand wordt geladen.
|
* |
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
greeting_txt
in het werkgebied gevuld met de tekenreeks IDS_GREETING
uit het XML-taalbestand.
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 | () | methode |
public static function setString(stringID:String, languageCode:String, stringValue:String):void
Taalversie: | ActionScript 3.0 |
Productversie: | Flash CS3 |
Runtimeversies: | Flash Player 9, AIR 1.0 |
Hiermee wordt de nieuwe tekenreekswaarde van een opgegeven tekenreeks-id en taalcode ingesteld.
Parameters
stringID:String — Het identificatienummer (id) van de tekenreeks die moet worden ingesteld.
| |
languageCode:String — De taalcode.
| |
stringValue:String — Een tekenreekswaarde.
|
Voorbeeld ( Hoe dit voorbeeld te gebruiken )
setString()
gebruikt om de tekenreeks IDS_WELCOME
in te stellen voor zowel Engels (en) als Frans (fr).
Locale.setString("IDS_WELCOME", "en", "hello"); Locale.setString("IDS_WELCOME", "fr", "bonjour"); trace(Locale.loadStringEx("IDS_WELCOME", "en")); // hello
Wed Jun 13 2018, 11:42 AM Z