StringTools  - AS3

Il nome dell'ID di impostazioni internazionali effettivamente utilizzato da questo oggetto StringTools.

Esistono tre possibilità per il valore del nome, a seconda del sistema operativo e del valore del parametro requestedLocaleIDName passato alla funzione di costruzione StringTools().

1. Se le impostazioni internazionali richieste non corrispondevano al valore LocaleID.DEFAULT e il sistema operativo fornisce il supporto per tali impostazioni internazionali, il nome restituito corrisponde alla proprietà requestedLocaleIDName.
2. Se è stato utilizzato LocaleID.DEFAULT come valore del parametro requestedLocaleIDName passato alla funzione di costruzione, viene utilizzato il nome delle impostazioni internazionali correnti specificato dal sistema operativo dell'utente. Il valore LocaleID.DEFAULT mantiene l'impostazione personalizzata dell'utente nel sistema operativo. Se passate un valore esplicito come parametro requestedLocaleIDName, non viene necessariamente restituito lo stesso risultato fornito da LocaleID.DEFAULT, anche se i nomi dei due ID di impostazioni internazionali sono gli stessi. L'utente potrebbe avere personalizzato le impostazioni internazionali del computer e la richiesta di un nome esplicito dell'ID di impostazioni internazionali, anziché l'utilizzo di LocaleID.DEFAULT, può impedire all'applicazione di rilevare tali impostazioni personalizzate.
3. Se il sistema operativo non supporta il parametro requestedLocaleIDName specificato nella funzione di costruzione, viene fornito un nome dell'ID di impostazioni internazionali di riserva.

Elementi API correlati

Lo stato dell'operazione più recente eseguita da questo oggetto StringTools. La proprietà lastOperationStatus viene impostata ogni volta che chiamate una funzione di costruzione o un metodo di questa classe oppure impostate un'altra proprietà. Per i valori possibili, fate riferimento alla descrizione dei singoli metodi.

Elementi API correlati

Il nome dell'ID di impostazioni internazionali richiesto, che è stato passato alla funzione di costruzione di questo oggetto StringTools.

Se è stato utilizzato il valore LocaleID.DEFAULT, il nome restituito è "i-default". Quando vengono applicate impostazioni internazionali di riserva, le impostazioni internazionali effettivamente utilizzate possono essere diverse da quelle richieste. Il nome delle impostazioni internazionali effettive può essere recuperato utilizzando la proprietà actualLocaleIDName.

Elementi API correlati

Crea un nuovo oggetto StringTools che fornisce la conversione maiuscolo/minuscolo e altre utilità, in base alle convenzioni di un determinato contesto di impostazioni internazionali.

Questa funzione di costruzione determina se il sistema operativo corrente supporta il nome dell'ID di impostazioni internazionali richiesto. Se non è supportato, vengono utilizzate delle impostazioni internazionali di riserva. Se vengono utilizzate impostazioni internazionali di riserva, la proprietà lastOperationStatus indica il tipo di riserva e la proprietà actualLocaleIDName contiene il nome dell'ID di impostazioni locali di riserva.

Quando questa funzione di costruzione viene completata correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Quando il nome dell'ID di impostazioni internazionali richiesto non è disponibile, lastOperationStatus è impostata su uno dei valori seguenti:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Elementi API correlati

Elenca tutti i nomi degli ID di impostazioni internazionali supportati da questa classe.

Se questa classe non è supportata dal sistema operativo corrente, il metodo restituisce un valore null.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Converte una stringa in lettere minuscole in base alle convenzioni della lingua. A seconda delle impostazioni locali, la lunghezza della stringa di output potrebbe differire leggermente da quella della stringa di input.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Converte una stringa in lettere maiuscole in base alle convenzioni della lingua. A seconda delle impostazioni locali, la lunghezza della stringa di output potrebbe differire leggermente da quella della stringa di input.

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

In questo esempio viene eseguita la procedura seguente:

1. Crea un oggetto StringTools.
2. Definisce tre stringhe con caratteri univoci delle lingue turca, greca e tedesca.
3. Converte ciascuna stringa in maiuscolo e minuscolo e visualizza i risultati. Nell'esempio viene illustrato l'interessante comportamento di impostazioni internazionali specifiche per caratteri come "ı" e "İ" (turco), "ß" (tedesco) e "Σςσ" (greco).

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