Paket | fl.lang |
Klasse | public class Locale |
Vererbung | Locale EventDispatcher Object |
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
-
"automatically at runtime"
– Flash Player ersetzt String-IDs durch solche Strings aus der XML-Datei, die dem von flash.system.capabilities.language zurückgegebenen Standardsprachcode des Systems entsprechen. -
"manually using stage language"
– Beim Kompilieren werden String-IDs durch Strings ersetzt, die von Flash Player nicht mehr geändert werden können. -
"via ActionScript at runtime"
– Die Ersetzung der String-IDs wird zur Laufzeit mithilfe von ActionScript geregelt. Anhand dieser Option können Sie steuern, wann und in welcher Sprache die String-IDs ersetzt werden.
Die Eigenschaften und Methoden dieser Klasse können Sie verwenden, wenn Sie sich für die Option "mithilfe von ActionScript zur Laufzeit" entscheiden.
Alle verfügbaren Eigenschaften und Methoden sind statisch. Das bedeutet, dass der Zugriff über die Klasse "fl.lang.Locale" selbst erfolgt und nicht über eine Instanz der Klasse.
Hinweis: Die Locale-Klasse ist im Flash Authoring-Klassenpfad installiert und wird automatisch in Ihre SWF-Dateien kompiliert. Durch die Verwendung der Locale-Klasse vergrößert sich die SWF-Datei etwas, da die Klasse in die Datei kompiliert werden muss.
Verwandte API-Elemente
Eigenschaft | Definiert von | ||
---|---|---|---|
autoReplace : Boolean [statisch]
Bestimmt, ob die Strings nach dem Laden der XML-Datei automatisch ersetzt werden. | Locale | ||
constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | ||
languageCodeArray : Array [statisch] [schreibgeschützt]
Ein Array mit Sprachencodes für die Sprachen, die angegeben oder in die FLA-Datei geladen wurden. | Locale | ||
stringIDArray : Array [statisch] [schreibgeschützt]
Ein Array mit allen String-IDs in der FLA-Datei. | Locale |
Methode | Definiert von | ||
---|---|---|---|
[statisch]
Fügt das {instance, string ID}-Paar für eine spätere Verwendung in das interne Array ein. | Locale | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | ||
[statisch]
Fügt das {languageCode, languagePath}-Paar zur späteren Verwendung in das interne Array ein. | Locale | ||
[statisch]
Gibt „true“ zurück, wenn die XML-Datei geladen wurde, andernfalls „false“. | Locale | ||
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | ||
[statisch]
Der Standardsprachencode. Wird im Bedienfeld für Strings gesetzt oder durch Aufruf der setDefaultLang()-Methode. | Locale | ||
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | ||
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | ||
[statisch]
Ermittelt automatisch die zu verwendende Sprache und beginnt, die XML-Sprachdatei zu laden. | Locale | ||
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | ||
[statisch]
Lädt die angegebene XML-Sprachdatei. | Locale | ||
[statisch]
Gibt den mit der angegebenen String-ID verbundenen Stringwert in der aktuellen Sprache aus. | Locale | ||
[statisch]
Gibt den mit der angegebenen String-ID und dem angegebenen Sprachencode verbundenen Stringwert zurück. | Locale | ||
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | ||
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | ||
[statisch]
Legt den Standardsprachencode fest. | Locale | ||
[statisch]
Setzt die Rückruffunktion, die nach dem Laden der XML-Datei aufgerufen wird. | Locale | ||
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | ||
[statisch]
Legt den neuen Stringwert für eine angegebene String-ID und einen Sprachencode fest. | Locale | ||
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | ||
Gibt das angegebene Objekt als String zurück. | Object | ||
Gibt den Grundwert des angegebenen Objekts zurück. | Object | ||
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher |
autoReplace | Eigenschaft |
autoReplace:Boolean
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Bestimmt, ob die Strings nach dem Laden der XML-Datei automatisch ersetzt werden. Wird diese Eigenschaft auf true
gesetzt, so entspricht die Textersetzungsmethode der Einstellung "automatically at runtime"
im Bedienfeld für Strings. Das bedeutet, dass Flash Player die Standardsprache der Host-Umgebung ermittelt und den Text automatisch in dieser Sprache anzeigt. Wird diese Eigenschaft auf false
gesetzt, so entspricht die Textersetzungsmethode der Einstellung "via ActionScript at runtime"
im Bedienfeld für Strings. Das bedeutet, dass Sie für das Laden der für die Anzeige des Texts geeigneten XML-Datei selbst verantwortlich sind.
Der Standardwert dieser Eigenschaft entspricht der Einstellung von "Strings ersetzen" im Dialogfeld "Einstellungen" des Bedienfelds "Strings": true
für "automatically at runtime"
(Standardeinstellung) und false
für "via ActionScript at runtime".
Implementierung
public static function get autoReplace():Boolean
public static function set autoReplace(value:Boolean):void
Beispiel ( Verwendung dieses Beispiels )
Locale.autoReplace
das dynamisch erstellte Textfeld greeting_txt
auf der Bühne mit dem Inhalt des Strings IDS_GREETING
in der englischen XML-Datei gefüllt. Klicken Sie im Bedienfeld "Strings" auf die Schaltfläche "Einstellungen", um das Dialogfeld "Einstellungen" zu öffnen. Im Dialogfeld "Einstellungen" können Sie zwei aktive Sprachen hinzufügen: Englisch (en) und Französisch (fr). Legen Sie für die Ersatzstrings die Option "via ActionScript at runtime"
fest und klicken Sie auf "OK". Geben Sie anschließend die String-ID IDS_GREETING in das Bedienfeld "Strings" ein und fügen Sie Text für die aktiven Sprachen hinzu.
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 | Eigenschaft |
languageCodeArray:Array
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Ein Array mit Sprachencodes für die Sprachen, die angegeben oder in die FLA-Datei geladen wurden. Die Sprachencodes sind nicht alphabetisch sortiert.
Implementierung
public static function get languageCodeArray():Array
Beispiel ( Verwendung dieses Beispiels )
lang_cb
. Mit dem Textwerkzeug erstellen Sie ein dynamisches Textfeld mit dem Instanznamen greeting_txt
. Im Bedienfeld "Strings" fügen Sie mindestens zwei aktive Sprachen hinzu, legen für die Ersatzstrings die Option "via ActionScript at runtime"
fest und klicken auf "OK". Als Nächstes fügen Sie die String-ID IDS_GREETING hinzu und geben Text für die aktiven Sprachen ein. Anschließend fügen Sie in Bild 1 der Hauptzeitleiste den folgenden ActionScript-Code hinzu:
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 | Eigenschaft |
stringIDArray:Array
[schreibgeschützt] Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Ein Array mit allen String-IDs in der FLA-Datei. Die String-IDs sind nicht alphabetisch sortiert.
Implementierung
public static function get stringIDArray():Array
Beispiel ( Verwendung dieses Beispiels )
Locale.stringIDArray
-Eigenschaft für die aktuell geladene Sprach-XML-Datei ermittelt. Klicken Sie im Bedienfeld "Strings" auf die Schaltfläche "Einstellungen", um das Dialogfeld "Einstellungen" zu öffnen. Fügen Sie anschließend zwei aktive Sprachen hinzu: Englisch (en) und Französisch (fr). Legen Sie für die Ersatzstrings die Option "via ActionScript at runtime"
fest und klicken Sie auf "OK". Geben Sie im Bedienfeld "Strings" die String-ID IDS_GREETING ein und fügen Sie Text für die aktiven Sprachen hinzu.
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):*
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Fügt das {instance, string ID}-Paar für eine spätere Verwendung in das interne Array ein. Diese Methode wird hauptsächlich von Flash verwendet, wenn als Stringersetzungsoption "automatically at runtime"
gewählt wurde.
Parameter
instance:Object — Instanzname des zu füllenden Textfelds.
| |
stringID:String — Sprachstring-ID.
|
* |
Beispiel ( Verwendung dieses Beispiels )
autoReplace
und der Methode addDelayedInstance()
das Textfeld auf der Bühne mit dem String IDS_GREETING
der englischen XML-Sprachdatei gefüllt.
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
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Fügt das {languageCode, languagePath}-Paar zur späteren Verwendung in das interne Array ein. Diese Methode wird hauptsächlich von Flash Player verwendet, wenn als Stringersetzungsmethode "automatically at runtime"
oder "via ActionScript at runtime"
gewählt wurde. Mit dieser Methode können Sie XML-Sprachendateien von einem benutzerdefinierten Speicherort anstatt vom in Flash Professional festgelegten Standardspeicherort laden. Standardmäßig erstellt Flash Professional eine XML-Datei für jede Sprache in Ihrem Arbeitsverzeichnis, und zwar in einem Unterverzeichnis, das nach Ihrer FLA-Datei benannt wurde.
Parameter
langCode:String — Der Sprachencode.
| |
path:String — Der hinzuzufügende XML-Pfad.
|
Beispiel ( Verwendung dieses Beispiels )
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
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Gibt true
zurück, wenn die XML-Datei geladen wurde, andernfalls false
.
Boolean — Gibt true zurück, wenn die XML-Datei geladen wurde, andernfalls false .
|
Beispiel ( Verwendung dieses Beispiels )
greeting_txt
auf der Bühne mit dem String IDS_GREETING
aus der Sprach-XML-Datei gefüllt.
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
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Der Standardsprachencode. Wird im Bedienfeld für Strings gesetzt oder durch Aufruf der Methode setDefaultLang()
.
String — Gibt den Standardsprachencode zurück.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
defLang
erstellt, die zur Speicherung der anfänglichen Standardsprache für das Flash-Dokument verwendet wird. Im Bedienfeld "Strings" klicken Sie auf die Schaltfläche "Einstellungen", um das Dialogfeld "Einstellungen" zu öffnen. Anschließend fügen Sie zwei aktive Sprachen hinzu: Englisch (en) und Französisch (fr). Legen Sie für die Ersatzstrings die Option "via ActionScript at runtime"
fest und klicken Sie auf "OK". Geben Sie im Bedienfeld "Strings" die String-ID IDS_GREETING ein und fügen Sie Text für die aktiven Sprachen hinzu.
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
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Ermittelt automatisch die zu verwendende Sprache und beginnt, die XML-Sprachdatei zu laden. Diese Methode wird hauptsächlich von Flash verwendet, wenn als Stringersetzungsoption "automatically at runtime"
gewählt wurde.
Beispiel ( Verwendung dieses Beispiels )
initialize()
automatisch das Textfeld greeting_txt
auf der Bühne mit der aktuellen Betriebssystemsprache des Benutzers gefüllt wird. Statt die Methode initialize()
direkt zu verwenden, verwenden Sie die Stringersetzungsoption "automatically at runtime"
.
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
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Lädt die angegebene XML-Sprachdatei.
Parameter
xmlLanguageCode:String — Der Sprachcode für die zu ladende XML-Sprachdatei.
| |
customXmlCompleteCallback:Function (default = null ) — Individuelle Rückruffunktion, die beim Laden der XML-Sprachdatei aufgerufen werden soll.
|
Beispiel ( Verwendung dieses Beispiels )
loadLanguageXML()
die englische (en) XML-Sprachdatei geladen. Sobald die Sprachdatei geladen wurde, wird die Methode localeCallback()
aufgerufen und das Textfeld greeting_txt
auf der Bühne wird mit dem Inhalt des Strings IDS_GREETING
aus der XML-Datei gefüllt.
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
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Gibt den mit der angegebenen String-ID verbundenen Stringwert in der aktuellen Sprache aus.
Parameter
id:String — Die Identifikationsnummer (ID) des zu ladenden Strings.
|
String — Der mit der angegebenen String-ID verbundene Stringwert in der aktuellen Sprache.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
greeting_txt
auf der Bühne mit dem String IDS_GREETING
aus der XML-Sprachdatei gefüllt.
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
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Gibt den mit der angegebenen String-ID und dem angegebenen Sprachencode verbundenen Stringwert zurück. Um unbeabsichtigtes Laden von XML-Dateien zu verhindern, wird die XML-Sprachdatei durch loadStringEx()
nicht geladen, wenn sie noch nicht geladen worden ist. Sie sollten den richtigen Zeitpunkt für den Aufruf der Methode loadLanguageXML()
selbst bestimmen, wenn Sie eine XML-Sprachdatei laden möchten.
Parameter
stringID:String — Die Identifikationsnummer (ID) des zu ladenden Strings.
| |
languageCode:String — Der Sprachencode.
|
String — Der mit der angegebenen String-ID verbundene Stringwert in der vom Parameter languageCode angegebenen Sprache.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
loadStringEx()
der Wert des Strings IDS_GREETING
für die aktuell geladene französische Sprach-XML-Datei ermittelt.
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
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Legt den Standardsprachencode fest.
Parameter
langCode:String — Ein String, der für einen Sprachencode steht.
|
Verwandte API-Elemente
Beispiel ( Verwendung dieses Beispiels )
defLang
erstellt, die zur Speicherung der anfänglichen Standardsprache für das Flash-Dokument verwendet wird. Im Bedienfeld "Strings" klicken Sie auf die Schaltfläche "Einstellungen", um das Dialogfeld "Einstellungen" zu öffnen. Anschließend fügen Sie zwei aktive Sprachen hinzu: Englisch (en) und Französisch (fr). Legen Sie für die Ersatzstrings die Option "via ActionScript at runtime"
fest und klicken Sie auf "OK". Geben Sie im Bedienfeld "Strings" die String-ID IDS_GREETING ein und fügen Sie Text für die aktiven Sprachen hinzu.
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):*
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Setzt die Rückruffunktion, die nach dem Laden der XML-Datei aufgerufen wird.
Parameter
loadCallback:Function — Die Funktion, die beim Laden der XML-Sprachdatei aufgerufen werden soll.
|
* |
Beispiel ( Verwendung dieses Beispiels )
greeting_txt
auf der Bühne mit dem String IDS_GREETING
aus der XML-Sprachdatei gefüllt.
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
Sprachversion: | ActionScript 3.0 |
Produktversion: | Flash CS3 |
Laufzeitversionen: | Flash Player 9, AIR 1.0 |
Legt den neuen Stringwert für eine angegebene String-ID und einen Sprachencode fest.
Parameter
stringID:String — Die Identifikationsnummer (ID) des zu setzenden Strings.
| |
languageCode:String — Der Sprachencode.
| |
stringValue:String — Ein Stringwert.
|
Beispiel ( Verwendung dieses Beispiels )
setString()
der String IDS_WELCOME
für Englisch (en) und Französisch (fr) festgelegt.
Locale.setString("IDS_WELCOME", "en", "hello"); Locale.setString("IDS_WELCOME", "fr", "bonjour"); trace(Locale.loadStringEx("IDS_WELCOME", "en")); // hello
Tue Jun 12 2018, 10:04 AM Z