LocaleID  - AS3

Der Status der letzten Operation, die dieses LocaleID-Objekt ausgeführt hat. Die lastOperationStatus-Eigenschaft wird immer festgelegt, wenn der Konstruktor oder eine Methode dieser Klasse aufgerufen oder eine andere Eigenschaft festgelegt wird. Die möglichen Werte sind in der Beschreibung der einzelnen Methoden aufgeführt.

Verwandte API-Elemente

Gibt einen etwas „kanonischeren“ Gebietsschemabezeichner zurück.

Diese Methode führt die folgenden Konvertierungen am Namen der Gebietsschema-ID aus, um ihn eine kanonischere Form zu geben:

• Auf alle Komponenten wird die richtige Groß- und Kleinschreibung angewendet.
• Unterstriche werden in Bindestriche umgewandelt.

Es wird keine weitere Verarbeitung ausgeführt. So werden Aliasnamen zum Beispiel nicht ersetzt und es werden keine Elemente hinzugefügt oder entfernt.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Konstruiert ein neues LocaleID-Objekt mit einem Gebietsschemanamen. Der Name des Gebietsschemas muss der im Unicode Technical Standard #35 (http://unicode.org/reports/tr35/) definierten Syntax entsprechen.

Wenn der Konstruktor erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft auf diesen Wert gesetzt:

• LastOperationStatus.NO_ERROR

Wenn der angeforderte Gebietsschema-ID-Name nicht verfügbar ist, hat lastOperationStatus einen der folgenden Werte:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Details zu den oben aufgeführten Warnungen und zu anderen möglichen Werten der lastOperationStatus-Eigenschaft finden Sie im Abschnitt zur LastOperationStatus-Klasse.

Verwandte API-Elemente

Gibt eine Liste akzeptierter Gebietsschemas zurück, die auf einer Liste der gewünschten Gebietsschemas und einer Liste der zurzeit verfügbaren Gebietsschemas basiert.

Die resultierende Liste ist nach Präferenz geordnet.

Dies ist ein typischer Einsatz dieser Methode:

• Ein Benutzer gibt eine Liste der Sprachen an, die er versteht (in einem Benutzerprofil, einer Browsereinstellung oder einem Cookie gespeichert). Der Benutzer gibt die Sprachen, die er am besten versteht, als erste an; die Reihenfolge der Sprachen in dieser Liste ist also relevant. Diese Liste ist die Liste der gewünschten Sprachen („Want-Liste“).
• Die Anwendung wurde in verschiedene Sprachen lokalisiert. Diese Liste ist die Liste der verfügbaren Sprachen („Have-Liste)“.
• Die determinePreferredLocales()-Methode gibt die Schnittmenge der beiden Listen zurück. Diese ist so sortiert, dass die vom Benutzer bevorzugten Sprachen zuerst aufgeführt sind.

Wenn diese Funktion vom aktuellen Betriebssystem nicht unterstützt wird, gibt diese Methode einen Null-Wert zurück.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Parameter

Verwandte API-Elemente

Gibt ein Objekt zurück, das alle Schlüssel-Wert-Paare aus dem LocaleID-Objekt enthält.

Das zurückgegebene Objekt ist als Hash-Tabelle oder assoziatives Array strukturiert, wobei jeder Eigenschaftenname einen Schlüssel und der Wert der Eigenschaft den Wert repräsentiert. Mit dem folgenden Code werden zum Beispiel alle Schlüssel und Werte aufgeführt, die mit der getKeysAndValues()-Methode vom LocaleID-Objekt abgerufen werden:

         var myLocale:LocaleID = new LocaleID("fr-CA");
         var localeData:Object = myLocale.getKeysAndValues();
         for (var propertyName:String in localeData)
         {
           trace(propertyName + " = " + localeData[propertyName]);
         }
         

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Verwandte API-Elemente

Gibt den Sprachcode zurück, der vom Namen der Gebietsschema-ID angegeben wird.

Wenn der Name des Gebietsschemas nicht korrekt analysiert werden kann, ist der Sprachcode mit dem vollständigen Gebietsschemanamen identisch.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Verwandte API-Elemente

Gibt den Regionscode zurück, der vom Namen der Gebietsschema-ID angegeben wird.

Diese Methode gibt einen leeren String zurück, wenn der Regionscode nicht analysiert oder „erraten“ werden kann. Dies kann vorkommen, wenn ein unbekannter oder ein unvollständiger Gebietsschema-ID-Name wie „xy“ verwendet wird. Der Regionscode wird nicht anhand einer festen Liste validiert. Zum Beispiel wird für den Gebietsschema-ID-Namen „xx-YY“ der Regionscode „YY“ zurückgegeben.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Wenn die Region nicht Teil des angegebenen Gebietsschemanamens ist, wird der wahrscheinlichste Regionscode für das Gebietsschema „geraten“ und die lastOperationStatus-Eigenschaft wird auf LastOperationStatus.USING_FALLBACK_WARNING gesetzt.

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Verwandte API-Elemente

Gibt den Skriptcode zurück, der vom Namen der Gebietsschema-ID angegeben wird.

Diese Methode gibt einen leeren String zurück, wenn der Skriptcode nicht analysiert oder „erraten“ werden kann. Dies kann vorkommen, wenn ein unbekannter oder ein unvollständiger Gebietsschema-ID-Name wie „xy“ verwendet wird. Der Skriptcode wird nicht anhand einer festen Liste validiert. Zum Beispiel wird für den Gebietsschema-ID-Namen „xx-Abcd-YY“ der Skriptcode „Abcd“ zurückgegeben.

Die Region kann wie die Sprache den Rückgabewert beeinflussen. Der Skriptcode für „mn-MN“ (Mongolisch-Mongolei) ist zum Beispiel „Cyrl“ (Kyrillisch), während der Skriptcode für „mn-CN“ (Mongolisch-China) „Mong“ (Mongolisch) lautet.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Wenn der Skriptcode nicht Teil des angegebenen Gebietsschemanamens ist, wird der wahrscheinlichste Skriptcode für das Gebietsschema „geraten“ und die lastOperationStatus-Eigenschaft wird auf LastOperationStatus.USING_FALLBACK_WARNING gesetzt.

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Verwandte API-Elemente

Gibt den Sprachvariantencode zurück, der vom Namen der Gebietsschema-ID angegeben wird.

Diese Methode gibt einen leeren String zurück, wenn der angegebene Gebietsschema-ID-Name keinen Sprachvariantencode enthält. (Es muss nicht geraten werden, da nur wenige Gebietsschemas eine Sprachvariante haben oder benötigen.)

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Verwandte API-Elemente

Legt fest, ob die Textrichtung für das angegebene Gebietsschema von links nach rechts verläuft.

Mit dem Ergebnis kann die Textrichtung in der Flash-Text-Engine bestimmt und entschieden werden, ob die Benutzeroberfläche gespiegelt werden sollte, um die aktuelle Textrichtung zu unterstützen.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Verwandte API-Elemente

Gibt an, dass die Standardspracheinstellungen des Benutzers verwendet werden wie in den Betriebssystemeinstellungen des Benutzers angegeben. Diese Einstellungen werden normalerweise in der „Systemsteuerung“ von Windows bzw. in den „Systemeinstellungen“ unter Mac OS X vorgenommen.

Die Verwendung der LocaleID.DEFAULT-Einstellung kann dazu führen, dass für verschiedene Vorgänge unterschiedliche Gebietsschema-ID-Namen verwendet werden. Zum Beispiel könnte ein bestimmtes Gebietsschema beim Sortieren und ein anderes beim Formatieren zum Einsatz kommen. Mit dieser Flexibilität werden die Voreinstellungen des Benutzers berücksichtigt; dies ist das Standardverhalten der Klasse.

Dieser Gebietsschemabezeichner ist nicht immer der am besten geeignete. Bei Anwendungen, die im Browser ausgeführt werden, könnte das im Browser bevorzugte Gebietsschema die bessere Wahl sein. Häufig empfiehlt es sich, dem Benutzer die Möglichkeit zu geben, die Einstellung für den bevorzugten Gebietsschema-ID-Namen zu ändern und diese Einstellung in einem Benutzerprofil, einem Cookie oder einem gemeinsam genutzten Objekt zu speichern.

In diesem Beispiel werden die folgenden Gebietsschemas verwendet: Arabisch (Saudi-Arabien), Englisch (USA), Englisch (USA, POSIX-Variante), Chinesisch (VR China), Chinesisch (Taiwan), Chinesisch (Vereinfachte Han-Schriftzeichen), Chinesisch (VR China mit verschiedenen Tasten und Werten).

Das Beispiel führt für jedes Gebietsschema in der Liste Folgendes aus:

1. Erstellt ein neues LocaleID-Objekt.
2. Zeigt verschiedene Eigenschaften von LocaleID an. Die angezeigten Werte variieren in Abhängigkeit von Ihrem Betriebssystem und den Benutzereinstellungen.
3. Zeigt den vollständigen Satz von Schlüsseln und Werten für LocaleID an.

package 
{
    import flash.display.Sprite;
    import flash.globalization.LocaleID;
    
    public class LocaleIDExample extends Sprite
    {
        public function LocaleIDExample()
        {
            var localeNames:Array = ["ar-SA", "EN_us", "en-US-POSIX", "zh-CH", "zh-TW", "zh-Hans", "zh-CH@collation=pinyin;calendar=chinese;currency=RMB"];
            
            for ( var i:int = 0; i < localeNames.length; i++ ) 
            {
                var locID:LocaleID = new LocaleID( localeNames[i] as String );
                
                trace('\n\n' + "LocaleID requested: " + locID.requestedLocaleIDName 
                    + "; actual: " + locID.actualLocaleIDName);
                trace( "Last Operation Status after new LocaleID: " + locID.lastOperationStatus);
                
                trace("name:     " + locID.name);
                trace("language: " + locID.getLanguage() + "; status: "  + locID.lastOperationStatus);
                trace("script:   " + locID.getScript()  +  "; status: "  + locID.lastOperationStatus);
                trace("region:   " + locID.getRegion()  +  "; status: "  + locID.lastOperationStatus);
                trace("variant:  " + locID.getVariant()  + "; status: "  + locID.lastOperationStatus);
                trace("isRightToLeft: ", locID.isRightToLeft(), "; status: "  + locID.lastOperationStatus);
                
                var keysAndValues:Object = locID.getKeysAndValues();
                var key:String;
                for (key in keysAndValues)
                {
                    trace("key: ", key + " value: " + keysAndValues[ key ]);
                }
                trace( "Last Operation Status after getKeysAndValues(): " + locID.lastOperationStatus);
            }
        }
    }
}