StringTools  - AS3

O nome da localidade real ID usado por este objeto de StringTools.

Há três possibilidades para o valor do nome, dependendo do sistema operacional e o valor do parâmetro requestedLocaleIDName passado para o construtor StringTools().

1. Se o idioma solicitado não for LocaleID.DEFAULT e o sistema operacional oferecer suporte para o idioma solicitado, o nome retornado será o mesmo da propriedade requestedLocaleIDName.
2. Se LocaleID.DEFAULT foi usado como o valor do parâmetro requestedLocaleIDName para o construtor, o nome do idioma atual especificado pelo sistema operacional do usuário será usado. O valor LocaleID.DEFAULT preserva a configuração personalizada do usuário no sistema operacional. Observe que a passagem de um valor explícito como o parâmetrorequestedLocaleIDName não tem necessariamente o mesmo resultado que o uso de LocaleID.DEFAULT, mesmo que os dois nomes de ID de idioma sejam iguais. O usuário poderia ter personalizado as configurações de idioma em sua máquina e, ao solicitar um nome de ID de idioma explícito em vez de usar LocaleID.DEFAULT, o aplicativo não recuperaria as configurações personalizadas.
3. Se o sistema não suporta o requestedLocaleIDName especificado no construtor, é fornecido um nome de ID de local de retrocesso.

Elementos da API relacionados

O status da operação mais recente que este objeto StringTools executou. A propriedade lastOperationStatus será definida sempre que o construtor ou um método desta classe forem chamados ou sempre que outra propriedade for definida. Para ver os valores possíveis, consulte a descrição de cada método.

Elementos da API relacionados

O nome do ID da localidade solicitada que foi passado ao construtor deste objeto StringTools.

Se o valor LocaleID.DEFAULT tiver sido usado, então o nome retornado será "i-default". A localidade real usada pode diferenciar-se da localidade solicitada quando uma localidade de retorno é aplicada. É possível recuperar nome do local real pode ser recuperado usando o actualLocaleIDName propriedade.

Elementos da API relacionados

Constrói um novo objeto StringTools que fornece a conversão de maiúsculas e minúsculas e outros utilitários segundo as convenções de um determinado idioma.

Este construtor determinará se o sistema operacional atual suporta o local o nome de ID de localidade solicitado. Se não suportar, será usado um idioma de retorno. Se um idioma de retorno for usado, a propriedade lastOperationStatus indicará o tipo de retorno, e a propriedade actualLocaleIDName conterá o nome do ID do idioma de retorno.

Quando este construtor é concluído com sucesso, a propriedade lastOperationStatus é definida para:

• LastOperationStatus.NO_ERROR

Quando o nome de ID de local solicitado não está disponível, lastOperationStatus é configurado como uma das alternativas a seguir:

• LastOperationStatus. USING_FALLBACK_WARNING
• LastOperationStatus. USING_DEFAULT_WARNING

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Elementos da API relacionados

Lista todos os nomes de ID de local suportados por essa classe.

Se esta classe não for suportada no sistema operacional atual, este método retornará um valor nulo.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Converte uma string em minúsculas de acordo com as convenções do idioma. Dependendo do idioma, o comprimento da string de saída poderá ser diferente do comprimento da string de entrada.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Converte uma string em maiúsculas de acordo com as convenções do idioma. Dependendo do idioma, o comprimento da string de saída poderá ser diferente do comprimento da string de entrada.

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Este exemplo toma as seguintes medidas:

1. Cria um objeto StringTools.
2. Define três strings com caracteres exclusivos para os idiomas turco, grego e alemão.
3. Converte cada string para maiúsculas e minúsculas e exibe os resultados. Este exemplo demonstra o comportamento específico do idioma de interesse para caracteres como o "Ä ±" e o "Ä °" turcos, o "ß" alemão, e os "Î £�?‚ �? ƒ" gregos.

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