LocaleID  - AS3

Etat de la dernière opération que cet objet LocaleID a effectuée. La propriété lastOperationStatus est définie chaque fois que le constructeur ou une méthode de cette classe est appelé(e), ou qu’une autre propriété est définie. Pour les valeurs disponibles, voir la description de chaque méthode.

Eléments de l’API associés

Renvoie un identificateur de paramètres régionaux légèrement plus « canonique ».

Cette méthode effectue les conversions suivantes pour donner au nom de l’ID de paramètres régionaux une forme plus canonique.

• La casse appropriée est appliquée à l’ensemble des composants.
• Les traits de soulignement sont convertis en tirets.

Aucun traitement supplémentaire n’est effectué. Par exemple, les alias ne sont pas remplacés, et aucun élément n’est ajouté ou supprimé.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

• LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Construit un nouvel objet LocaleID en fonction du nom d’un paramètre régional. Le nom du paramètre régional doit être conforme à la syntaxe définie par la norme technique Unicode nº 35 (http://unicode.org/reports/tr35/).

Lorsque le constructeur se termine avec succès, la propriété lastOperationStatus est définie sur :

• LastOperationStatus.NO_ERROR

Lorsque le nom de l’identificateur de paramètres régionaux requis n’est pas disponible, la propriété lastOperationStatus est définie sur l’une des valeurs suivantes :

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Pour plus d’informations sur les avertissements répertoriés ci-dessus et d’autres valeurs possibles de la propriété lastOperationStatus, voir les descriptions de la classe LastOperationStatus.

Eléments de l’API associés

Renvoie une liste de paramètres régionaux acceptables basée sur une liste de paramètres régionaux souhaitables et sur une liste des paramètres régionaux actuellement disponibles.

La liste résultante est classée par ordre de préférence.

Voici un exemple d’usage courant de cette méthode :

• Un utilisateur spécifie une liste de langues qu’il comprend (enregistrée dans un profil utilisateur, un navigateur ou un cookie). L’utilisateur répertorie en premier les langues qu’il comprend le mieux ; l’ordre de classement des langues dans la liste est donc important. Il s’agit de la liste "want" (souhaitée).
• L’application est localisée dans un certain nombre de langues. Il s’agit de la liste "have" (réelle).
• La méthode determinePreferredLocales() renvoie une intersection des deux listes, classée de façon à ce que les langues préférées de l’utilisateur apparaissent en premier.

Si cette fonction n’est pas prise en charge sur le système d’exploitation actuel, cette méthode renvoie une valeur nulle.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

• LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Paramètres

Eléments de l’API associés

Renvoie un objet contenant toutes les paires clé-valeur de l’objet LocaleID.

L’objet renvoyé est structuré comme une table de hachage ou un tableau associatif, où chaque nom de propriété représente une clé, et où la valeur de la propriété représente la valeur de cette clé. Par exemple, le code suivant répertorie toutes les clés et les valeurs transmises via l’objet LocaleID à l’aide de la méthode getKeysAndValues() :

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

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

• LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Eléments de l’API associés

Renvoie le code de langue spécifié par le nom de l’ID de paramètres régionaux.

S’il s’avère impossible d’analyser correctement le nom du paramètre régional, le code de langue est alors identique au nom complet du paramètre régional.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

• LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Eléments de l’API associés

Renvoie le code de région spécifié par le nom de l’ID de paramètres régionaux.

Cette méthode renvoie une chaîne vide s’il s’avère impossible d’analyser ou de deviner le code de région, notamment si un nom d’ID de paramètres régionaux inconnu ou incomplet (par exemple, "xy") est utilisé. Le code de région n’est pas validé en fonction d’une liste. Par exemple, le code de région renvoyé pour un nom d’ID de paramètres régionaux tel que "xx-yy" est "YY".

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

• LastOperationStatus.NO_ERROR

Si la région ne fait pas partie du nom du paramètre régional spécifié, le code de région le plus ressemblant est « deviné », et la propriété lastOperationStatus est définie sur LastOperationStatus.USING_FALLBACK_WARNING.

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Eléments de l’API associés

Renvoie le code de script spécifié par le nom de l’ID de paramètres régionaux.

Cette méthode renvoie une chaîne vide s’il s’avère impossible d’analyser ou de deviner le code de région, notamment si un nom d’ID de paramètres régionaux inconnu ou incomplet (par exemple, "xy") est utilisé. Le code de script n’est pas validé en fonction d’une liste. Par exemple, le code de script renvoyé pour un nom d’ID de paramètres régionaux tel que "xx-Abcd-YY" est "Abcd".

La région, ainsi que la langue, peuvent également avoir une incidence sur la valeur renvoyée. Par exemple, le code de script pour "mn-MN" (Mongolien-Mongolie) est "Cyrl" (Cyrillique), alors que le code de script pour "mn-CN" (Mongolien-Chine) est "Mong" (Mongolien).

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

• LastOperationStatus.NO_ERROR

Si le code de script ne fait pas partie du nom du paramètre régional spécifié, le code de script le plus ressemblant est « deviné », et la propriété lastOperationStatus définie sur LastOperationStatus.USING_FALLBACK_WARNING.

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Eléments de l’API associés

Renvoie le code de variante de langue spécifié par le nom de l’ID de paramètres régionaux.

Cette méthode renvoie une chaîne vide en l’absence de code de variante de langue dans le nom de l’ID de paramètres régionaux. (Il n’est pas nécessaire de deviner le code, car les paramètres régionaux nécessitant une variante de langue sont peu nombreux.)

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

• LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Eléments de l’API associés

Indique si le sens du texte correspondant aux paramètres régionaux spécifiés est de droite à gauche.

Le résultat obtenu peut être utilisé pour déterminer le sens du texte dans le moteur de texte de Flash et pour décider si l’interface utilisateur doit être mise en miroir en vue de prendre en charge le sens du texte actuel.

Lorsque cette méthode est appelée et que l’appel aboutit, la propriété lastOperationStatus est définie sur :

• LastOperationStatus.NO_ERROR

Sinon, la propriété lastOperationStatus est définie sur l’une des constantes définies dans la classe LastOperationStatus.

Eléments de l’API associés

Indique que les préférences linguistiques par défaut doivent être utilisées, comme le spécifient les paramètres du système d’exploitation de l’utilisateur. Par exemple, ces préférences sont généralement définies via le « Panneau de configuration » sous Windows ou les « Préférences système » sous Mac OS X.

L’utilisation du paramètre LocaleID.DEFAULT peut impliquer le recours à un autre nom d’ID de paramètres régionaux pour différents types d’opérations. Par exemple, il est possible d’utiliser des paramètres régionaux pour le classement et d’autres pour le formatage. Cette flexibilité respecte les préférences de l’utilisateur et la classe se comporte de cette façon par défaut.

Cet ID de paramètres régionaux n’est pas toujours le plus approprié. Pour les applications s’exécutant dans le navigateur, il est sans doute plus judicieux d’utiliser les paramètres régionaux favoris du navigateur. Par ailleurs, il est parfois préférable de laisser l’utilisateur modifier le nom de l’ID de paramètres régionaux favoris et de conserver cette préférence dans un profil utilisateur, un cookie ou un objet partagé.

Cet exemple utilise les paramètres régionaux suivants : Arabe (Arabie Saoudite), Anglais (Etats-Unis), Anglais (Etats-Unis, variante POXIS), Chinois (PRC), Chinois (Taiwan), Chinois (Han simplifié), Chinois (PRC avec plusieurs clés et valeurs).

Cet exemple effectue les opérations suivantes pour chaque jeu de paramètres régionaux dans la liste :

1. Crée un nouvel objet LocaleID.
2. Affiche plusieurs propriétés de l’objet LocaleID. Les valeurs indiquées diffèrent en fonction du système d’exploitation et des préférences de l’utilisateur.
3. Affiche le jeu complet de touches et valeurs pour l’objet LocaleID.

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