StringTools  - AS3

El nombre del ID real de configuración regional utilizado por este objeto StringTools.

Existen tres posibilidades para el valor del nombre, en función del sistema operativo y del valor del parámetro requestedLocaleIDName transferido al constructor StringTools().

1. Si la configuración regional requerida no era LocaleID.DEFAULT y el sistema operativo admite la configuración regional requerida, el nombre devuelto es el mismo que la propiedad requestedLocaleIDName.
2. Si LocaleID.DEFAULT se ha utilizado como el valor del parámetro requestedLocaleIDName en el constructor, se utiliza el nombre de la configuración regional actual especificado por el sistema operativo del usuario. El valor de LocaleID.DEFAULT conserva la configuración personalizada del usuario en el sistema operativo. Transferir un valor explícito como el parámetro requestedLocaleIDName no necesariamente produce el mismo resultado que utilizar LocaleID.DEFAULT incluso si los dos ID de configuración regional son los mismos. El usuario podría haber personalizado los ajustes de la configuración regional de su equipo y, al solicitar un nombre ID de configuración regional explícito en lugar de utilizar LocaleID.DEFAULT, la aplicación no recuperaría dichos ajustes personalizados.
3. Si el sistema no admite el nombre de requestedLocaleIDName especificado en el constructor, se proporciona un nombre de ID de configuración regional de repuesto.

Elementos de API relacionados

El estado de la última operación que este objeto StringTools 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

El nombre del ID de configuración regional requerido que se transfirió al constructor de este objeto StringTools.

Si se ha utilizado el valor LocaleID.DEFAULT, el nombre devuelto es "i-default". La configuración regional real que se utiliza puede ser diferente de la configuración regional requerida cuando cuando se aplica una configuración regional de repuesto. El nombre de la configuración regional real se puede recuperar usando la propiedad actualLocaleIDName.

Elementos de API relacionados

Construye un nuevo objeto StringTools que proporciona conversión de caja y otras utilidades según las convenciones de una configuración regional determinada.

Este constructor determina si el sistema operativo actual admite el nombre del ID solicitado configuración regional. Si no se admite, se utilizará en su lugar una configuración regional repuesto. Si se utiliza una configuración regional de repuesto, la propiedad lastOperationStatus indica el tipo de repuesto y la propiedad actualLocaleIDName contiene el nombre del ID de configuración regional de repuesto.

Cuando este 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.

Elementos de API relacionados

Muestra una lista de todos los nombres de ID de configuración regional admitidos por esta clase.

Si esta clase 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.

Convierte una cadena en minúsculas según sus convenciones de idioma. Dependiendo de la configuración regional, la longitud de la cadena de salida puede ser diferente de la longitud de la cadena de entrada.

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

Convierte una cadena en mayúsculas según sus convenciones de idioma. Dependiendo de la configuración regional, la longitud de la cadena de salida puede ser diferente de la longitud de la cadena de entrada.

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

Este ejemplo lleva a cabo los siguientes pasos:

1. Crea un objeto StringTools.
2. Define tres cadenas con caracteres únicos para turco, griego y alemán.
3. Convierte cada cadena en mayúsculas y minúsculas y muestra los resultados. Este ejemplo muestra un interesante comportamiento inherente a la configuración regional de caracteres como "ı" y "Ä°" en turco, "ß" en alemán o "Σςσ" en griego.

package {
    import flash.display.Sprite;
    import flash.globalization.LocaleID;
    import flash.globalization.StringTools;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;

    public class StringToolsExample extends Sprite
    {
        public function StringToolsExample()
        {
            var localeName:String= LocaleID.DEFAULT;
            var strTool:StringTools = new StringTools(localeName);
            
            trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName 
            + "; actual: " + nf.actualLocaleIDName);
            trace( "Last Operation Status:" + nf.lastOperationStatus );  
            
            var turkishStr:String = "iI ıİ";
            var greekStr:String = "Σςσβΰ�Σ";
            var germanStr:String= "ß";
            
            var tfTurInp:TextField = createTextField(10, 10);
            tfTurInp.text="Turkish Input: \t " + turkishStr;
            
            var tfdash:TextField = createTextField(10, 20);
            tfdash.text="-------------------";
            
            var tf1:TextField = createTextField(10, 30);
            tf1.text="\t Upper case: \t " + strTool.toUpperCase(turkishStr);
            
            var tf2:TextField = createTextField(10, 40);
            tf2.text="\t Lower case: \t " + strTool.toLowerCase(turkishStr);
            
            var tfgreekInp:TextField = createTextField(10, 60);
            tfgreekInp.text="Greek Input: \t " + greekStr;
            
            var tfdash1:TextField = createTextField(10, 70);
            tfdash1.text="-------------------";
            
            var tf3:TextField = createTextField(10, 80);
            tf3.text="\t Upper case: \t " + strTool.toUpperCase(greekStr);
            
            var tf4:TextField = createTextField(10, 90);
            tf4.text="\t Lower case: \t " + strTool.toLowerCase(greekStr);
            
            var tfgermanInp:TextField = createTextField(10, 110);
            tfgermanInp.text="German Input: \t " + germanStr;
            
            var tfdash2:TextField = createTextField(10, 120);
            tfdash2.text="-------------------";
                         
            var tf5:TextField = createTextField(10, 130);
            tf5.text="\t Upper case: \t " + strTool.toUpperCase(germanStr);
            
            var tf6:TextField = createTextField(10, 140);
            tf6.text="\t Lower case: \t " + strTool.toLowerCase(germanStr);
        }
        
        private function createTextField(x:Number, y:Number):TextField 
        {
            var result:TextField = new TextField();
            result.x = x;
            result.y = y;
            result.autoSize=TextFieldAutoSize.LEFT;
            addChild(result);
            return result;
        }
    }
}