LocaleID  - AS3

El estado de la última operación que este objeto LocaleID ha realizado. La propiedad lastOperationStatus se establece siempre que se llame al constructor o a un método de esta clase, o si se establece otra propiedad. Para conocer los valores posibles, consulte la descripción de cada método.

Elementos de API relacionados

Devuelve un identificador de configuración regional algo más "canónico".

Este método realiza la siguiente conversión en el nombre del ID de configuración regional para darle una forma más canónica.

• Envoltura adecuada que se aplica a todos los componentes.
• Los guiones bajos se convierten en guiones.

No se realiza ningún procesamiento adicional. Por ejemplo, no se sustituyen los alias y no se añaden ni se eliminan elementos.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Construye un nuevo objeto LocaleID, dado un nombre de configuración regional. El nombre de configuración regional debe ajustarse a la sintaxis definida por la Norma Técnica Unicode 35 (http://unicode.org/reports/tr35/).

Cuando el constructor se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

Cuando nombre del ID de la configuración regional no está disponible, lastOperationStatus se establece en uno de los valores siguientes:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Para obtener información detallada sobre las advertencias que aparecen en la lista anterior y sobre otros valores posibles de la propiedad lastOperationStatus, consulte las descripciones de la clase LastOperationStatus.

Elementos de API relacionados

Devuelve una lista de configuraciones regionales aceptables basadas en una lista de configuraciones regionales deseadas y una lista de configuraciones regionales actualmente disponibles.

La lista resultante se ordena por orden de preferencia.

A continuación se muestra un caso de uso habitual para este método:

• Un usuario especifica una lista de idiomas que entiende (almacenada en un perfil de usuario, una configuración de navegador o una cookie). El usuario enumera los idiomas que entiende mejor en primer lugar, por lo que el orden de los idiomas de la lista es importante. Ésta es la lista “deseada”.
• La aplicación se traduce a una serie de idiomas distintos. Ésta es la lista “real”.
• El método determinePreferredLocales() devuelve una intersección de las dos listas, ordenadas para que los idiomas preferidos del usuario se visualicen primero.

Si esta característica no se admite en el sistema operativo actual, este método devuelve un valor null.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Parámetros

Elementos de API relacionados

Devuelve un objeto que contiene todos los pares clave/valor desde el objeto LocaleID.

El objeto devuelto está estructurado como una tabla hash o conjunto asociativo, donde cada nombre de propiedad representa una clave y el valor de la propiedad es el valor de dicha clave. Por ejemplo, el siguiente código enumera todas las claves y valores obtenidos del objeto LocaleID utilizando el método getKeysAndValues():

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

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Elementos de API relacionados

Devuelve el código de idioma especificado por el nombre del ID de configuración regional.

Si el nombre de configuración regional no se puede analizar correctamente, el código de idioma es el mismo que el nombre toda la configuración regional.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Elementos de API relacionados

Devuelve el código regional especificado por el nombre del ID de configuración regional.

Este método devuelve una cadena vacía si el código de región no se puede analizar o deducir. Esto puede ocurrir si se utiliza un nombre de ID de configuración regional incompleto o desconocido, como "xy". El código de región no se valida comparándolo con una lista fija. Por ejemplo, el código de región devuelto para un nombre de ID de configuración regional "xx-YY" es "YY".

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

Si la región no forma parte del nombre de configuración regional especificado, se "deduce" el código de región más probable para la configuración regional y la propiedad lastOperationStatus se establece en LastOperationStatus.USING_FALLBACK_WARNING

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Elementos de API relacionados

Devuelve el código de script especificado por el nombre del ID de configuración regional.

Este método devuelve una cadena vacía si el código de script no se puede analizar o deducir. Esto puede ocurrir si se utiliza un nombre de ID de configuración regional incompleto o desconocido, como "xy". El código de script no se valida comparándolo con una lista fija. Por ejemplo, el código de script devuelto para un nombre de ID de configuración regional "xx-Abcd-YY" es "Abcd".

La región, así como el idioma, también pueden afectar al valor devuelto. Por ejemplo, el código de script para "mn-MN" (Mongol de Mongolia) es "Cyrl" (Cirílico), mientras el código de script para "mn-CN" (Mongol de China) es "Mong" (Mongol).

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

Si el código de scipt no forma parte del nombre de configuración regional especificado, se "deduce" el código de script más probable y la propiedad lastOperationStatus se establece en LastOperationStatus.USING_FALLBACK_WARNING.

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Elementos de API relacionados

Devuelve el código de variante de idioma especificado por el nombre del ID de configuración regional.

Este método devuelve una cadena vacía si no hay código de variante de idioma en el nombre del ID de configuración regional dado. (No es necesario deducirlo, ya que muy pocas configuraciones regionales tienen variante de idioma o la necesitan.)

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Elementos de API relacionados

Especifica si la dirección del texto para la configuración regional especificada es de derecha a izquierda.

El resultado se puede utilizar para determinar la dirección del texto del motor de texto de Flash y para decidir si la interfaz de usuario se reflejará para admitir la dirección actual del texto.

Cuando se llama a este método y se completa correctamente, la propiedad lastOperationStatus se establece en:

• LastOperationStatus.NO_ERROR

En caso contrario, la propiedad lastOperationStatus se establece en una de las constantes definidas en la clase LastOperationStatus.

Elementos de API relacionados

Indica que se deben utilizar las preferencias lingüísticas predeterminadas del usuario, conforme a lo especificado en la configuración del sistema operativo del usuario. Por ejemplo, estas preferencias se suelen establecer desde el "Panel de control" en Windows o desde "Preferencias del Sistema" en Mac OS X.

El uso del ajuste LocaleID.DEFAULT puede provocar el uso de un nombre de ID de configuración regional diferente para distintos tipos de operaciones. Por ejemplo, se puede utilizar una configuración regional para la ordenación y otra diferente para aplicar formato. Esta flexibilidad respeta las preferencias del usuario y el comportamiento de la clase es constante según el diseño.

Este identificador de configuración regional no siempre es el más adecuado para utilizar. En las aplicaciones que se ejecutan en el navegador, la configuración regional preferida del navegador puede ser una mejor elección. A menudo, es una buena idea permitir al usuario modificar el nombre del ID de la configuración regional preferida y conservar esa preferencia en un perfil de usuario, cookie u objeto compartido.

Este ejemplo utiliza las siguientes configuraciones regionales: árabe (Arabia Saudita), inglés (Estados Unidos), inglés (EE.UU., variante POSIX), chino (PRC), chino (Taiwán), chino (Han Script simplificado), chino (PRC con diversas claves y valores)

El ejemplo realiza las acciones siguientes para cada configuración regional de la lista:

1. Crea un nuevo objeto LocaleID.
2. Muestra varias propiedades de LocaleID. Los valores mostrados difieren en función del sistema operativo y las preferencias del usuario.
3. Muestra el conjunto completo de claves y valores para 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);
            }
        }
    }
}