Locale - Adobe ActionScript® 3 (AS3 Flash) API-Referenz

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

Mithilfe der fl.lang.Locale-Klasse können sie steuern, wie mehrsprachiger Text in einer SWF-Datei angezeigt wird. Das Flash-Bedienfeld "Strings" gestattet die Verwendung von String-IDs anstelle von String-Literalen in dynamischen Textfeldern. Dadurch können Sie eine SWF-Datei erstellen, die Text anzeigt, der aus einer sprachspezifischen XML-Datei geladen wurde. Die XML-Datei muss XLIFF (XML Localization Interchange File Format, XML-Dateiformat für den Austausch von Lokalisierungsinformationen) verwenden. Es gibt drei Möglichkeiten, um die in XLIFF-Dateien enthaltenen sprachspezifischen Strings anzuzeigen:

"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

flash.system.Capabilities.language

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	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

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		addDelayedInstance(instance:Object, stringID:String):* [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
		addXMLPath(langCode:String, path:String):void [statisch] Fügt das {languageCode, languagePath}-Paar zur späteren Verwendung in das interne Array ein.	Locale
		checkXMLStatus():Boolean [statisch] Gibt „true“ zurück, wenn die XML-Datei geladen wurde, andernfalls „false“.	Locale
		dispatchEvent(event:Event):Boolean Sendet ein Ereignis in den Ereignisablauf.	EventDispatcher
		getDefaultLang():String [statisch] Der Standardsprachencode. Wird im Bedienfeld für Strings gesetzt oder durch Aufruf der setDefaultLang()-Methode.	Locale
		hasEventListener(type:String):Boolean Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat.	EventDispatcher
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		initialize():void [statisch] Ermittelt automatisch die zu verwendende Sprache und beginnt, die XML-Sprachdatei zu laden.	Locale
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		loadLanguageXML(xmlLanguageCode:String, customXmlCompleteCallback:Function = null):void [statisch] Lädt die angegebene XML-Sprachdatei.	Locale
		loadString(id:String):String [statisch] Gibt den mit der angegebenen String-ID verbundenen Stringwert in der aktuellen Sprache aus.	Locale
		loadStringEx(stringID:String, languageCode:String):String [statisch] Gibt den mit der angegebenen String-ID und dem angegebenen Sprachencode verbundenen Stringwert zurück.	Locale
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Entfernt einen Listener aus dem EventDispatcher-Objekt.	EventDispatcher
		setDefaultLang(langCode:String):void [statisch] Legt den Standardsprachencode fest.	Locale
		setLoadCallback(loadCallback:Function):* [statisch] Setzt die Rückruffunktion, die nach dem Laden der XML-Datei aufgerufen wird.	Locale
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		setString(stringID:String, languageCode:String, stringValue:String):void [statisch] Legt den neuen Stringwert für eine angegebene String-ID und einen Sprachencode fest.	Locale
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object
		willTrigger(type:String):Boolean Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

Ereignisse

Klicken Sie, um weitere Informationen zu Ereignissen zu erhalten.

Vererbte Ereignisse ausblenden

Vererbte Ereignisse anzeigen

	Ereignis		Übersicht	Definiert von
		activate	[broadcast event] Wird ausgelöst, wenn Flash Player oder eine AIR-Anwendung den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
		deactivate	[broadcast event] Wird ausgelöst, wenn Flash Player- oder die AIR-Anwendung den Fokus verliert und inaktiv wird.	EventDispatcher

Eigenschaftendetails

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 )

Im folgenden Beispiel wird mit der Eigenschaft 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 )

Im folgenden Beispiel wird eine Sprach-XML-Datei auf der Grundlage des aktuellen Werts einer ComboBox-Komponente geladen. Sie ziehen eine ComboBox-Komponente auf die Bühne und geben ihr den Instanznamen 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 )

Im folgenden Beispiel wird die 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
     }

Methodendetails

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.

Rückgabewerte

*

Beispiel ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird mithilfe der Eigenschaft 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 )

Das folgende Beispiel teilt Flash Player mit, dass die englischen („en“) Übersetzungen in der Datei „locale/locale_en.xml“ und die französischen („fr“) in der Datei „locale/locale_fr.xml“ relativ zum Arbeitsverzeichnis zu finden sind (Beispiel und Beschreibung bereitgestellt von Chris Inch, von 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

()

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.

Rückgabewerte

Boolean — Gibt true zurück, wenn die XML-Datei geladen wurde, andernfalls false.

Beispiel ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird in einem 10 Millisekunden langen Intervall überprüft, ob die Sprachdatei erfolgreich geladen wurde. Sobald die XML-Datei geladen wurde, wird die Textfeld-Instanz 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().

Rückgabewerte

String — Gibt den Standardsprachencode zurück.

Verwandte API-Elemente

Locale.setDefaultLang()

Beispiel ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird die Variable 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 )

Aus diesem Beispiel geht hervor, wie mit der Methode 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 )

Im folgenden Beispiel wird mit der Methode 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.

Rückgabewerte

String — Der mit der angegebenen String-ID verbundene Stringwert in der aktuellen Sprache.

Verwandte API-Elemente

Locale.loadStringEx()

Beispiel ( Verwendung dieses Beispiels )

     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.

Rückgabewerte

String — Der mit der angegebenen String-ID verbundene Stringwert in der vom Parameter languageCode angegebenen Sprache.

Verwandte API-Elemente

Locale.loadString()

Beispiel ( Verwendung dieses Beispiels )

Im folgenden Beispiel wird mit der Methode 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

Locale.getDefaultLang()

Beispiel ( Verwendung dieses Beispiels )

     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.

Rückgabewerte

*

Beispiel ( Verwendung dieses Beispiels )

     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 )

Im folgenden Beispiel wird mit der Methode 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

Rechtliche Hinweise | Onlinedatenschutzerklärung

Locale - AS3 Flash

Paketex

Sprachelemente

Anhänge

Paket fl.lang

autoReplace

languageCodeArray

stringIDArray

addDelayedInstance

addXMLPath

checkXMLStatus

getDefaultLang

initialize

loadLanguageXML

loadString

loadStringEx

setDefaultLang

setLoadCallback

setString