fl.lang.Locale (ActionScript 3.0)

	Eigenschaft	Definiert von
		autoReplace : Boolean [static] 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 [static] [read-only] Ein Array mit Sprachencodes für die Sprachen, die angegeben oder in die FLA-Datei geladen wurden.	Locale
		prototype : Object [static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.	Object
		stringIDArray : Array [static] [read-only] Ein Array mit allen String-IDs in der FLA-Datei.	Locale

	Methode	Definiert von
		addDelayedInstance(instance:Object, stringID:String):* [static] 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 [static] Fügt das {languageCode, languagePath}-Paar zur späteren Verwendung in das interne Array ein.	Locale
		checkXMLStatus():Boolean [static] 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 [static] 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 [static] 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 [static] Lädt die angegebene XML-Sprachdatei.	Locale
		loadString(id:String):String [static] Gibt den mit der angegebenen String-ID verbundenen Stringwert in der aktuellen Sprache aus.	Locale
		loadStringEx(stringID:String, languageCode:String):String [static] 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 [static] Legt den Standardsprachencode fest.	Locale
		setLoadCallback(loadCallback:Function):* [static] 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 [static] Legt den neuen Stringwert für eine angegebene String-ID und einen Sprachencode fest.	Locale
		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 vorangegangenen Elementen ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist.	EventDispatcher

	Ereignis	Übersicht	Definiert von
		activate	Wird ausgelöst, wenn Flash Player den Betriebssystemfokus erhält und aktiv wird.	EventDispatcher
		deactivate	Wird ausgelöst, wenn Flash Player den Betriebssystemfokus verliert und inaktiv wird.	EventDispatcher

Eigenschaftsdetail

autoReplace

Eigenschaft

autoReplace:Boolean [read-write]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

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 function set autoReplace(value:Boolean):void

Beispiel

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 [read-only]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

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

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 [read-only]

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

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

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
     }

Methodendetail

addDelayedInstance

()

Methode

public static function addDelayedInstance(instance:Object, stringID:String):*

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

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

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

Player-Version :

Flash Player 9

Fügt das {languageCode, languagePath}-Paar zur späteren Verwendung in das interne Array ein. Diese Methode wird hauptsächlich von Flash verwendet, wenn als Stringersetzungsoption "automatically at runtime" oder "via ActionScript at runtime" gewählt wurde.

Parameter

	`langCode:String` — Der Sprachencode.

	`path:String` — Der hinzuzufügende XML-Pfad.

Beispiel

Im folgenden Beispiel wird mit der Methode setInterval() überprüft, ob die Sprach-XML-Datei erfolgreich geladen wurde.

     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");
     }

checkXMLStatus

()

Methode

public static function checkXMLStatus():Boolean

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

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

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

Player-Version :

Flash Player 9

Der Standardsprachencode. Wird im Bedienfeld für Strings gesetzt oder durch Aufruf der Methode setDefaultLang().

Rückgabewerte

String — Gibt den Standardsprachencode zurück.

Siehe auch

Locale.setDefaultLang()

Beispiel

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

Player-Version :

Flash Player 9

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

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

Player-Version :

Flash Player 9

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

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

Player-Version :

Flash Player 9

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.

Siehe auch

Locale.loadStringEx()

Beispiel

     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

Player-Version :

Flash Player 9

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.

Siehe auch

Locale.loadString()

Beispiel

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

Player-Version :

Flash Player 9

Legt den Standardsprachencode fest.

Parameter

langCode:String — Ein String, der für einen Sprachencode steht.

Siehe auch

Locale.getDefaultLang()

Beispiel

     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

Player-Version :

Flash Player 9

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

     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

Player-Version :

Flash Player 9

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

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

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/fl/lang/Locale.html

Komponenten-Referenzhandbuch für ActionScript 3.0		Alle Pakete \| Alle Klassen \| Sprachelemente \| Stichwortverzeichnis \| Anhänge \| Konventionen \| Frames Keine Frames
Locale	Eigenschaften \| Methoden \| Ereignisse

Paket	fl.lang
Klasse	public class Locale
Vererbung	Locale EventDispatcher Object