LocaleID  - AS3

Lo stato dell'operazione più recente eseguita da questo oggetto LocaleID. 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

Restituisce un identificatore di impostazioni internazionali leggermente più "canonico".

Questo metodo esegue la seguente conversione nel nome dell'ID di impostazioni internazionali per conferirgli un formato più canonico.

• A tutti i componenti viene applicato il formato maiuscole/minuscole appropriato.
• Le sottolineature vengono convertite in trattini.

Non vengono eseguite ulteriori elaborazioni. Gli alias, ad esempio, non vengono sostituiti e nessun elemento viene aggiunto o rimosso.

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.

Costruisce un nuovo oggetto LocaleID, in base al nome delle impostazioni internazionali. Il nome delle impostazioni internazionali deve essere conforme alla sintassi definita in Unicode Technical Standard #35 (http://unicode.org/reports/tr35/).

Quando la 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.

Per informazioni dettagliate sugli avvisi sopra indicati e altri possibili valori della proprietà lastOperationStatus, fate riferimento alle descrizioni disponibili nella classe LastOperationStatus.

Elementi API correlati

Restituisce un elenco di impostazioni internazionali accettabili in base a un elenco di impostazioni internazionali desiderate e a un elenco di quelle attualmente disponibili.

L'elenco risultate viene ordinato in base all'ordine di preferenza.

Di seguito è riportato un uso comune tipico per questo metodo:

• Un utente specifica un elenco di lingue conosciute (memorizzate in un profilo utente, un'impostazione del browser o un cookie). L'utente elenca per prime le lingue che conosce meglio, quindi l'ordine con cui sono elencate è rilevante. Questo è l'elenco "desiderato".
• L'applicazione è localizzata in diverse lingue. Questo è l'elenco "necessario".
• Il metodo determinePreferredLocales() restituisce un'intersezione dei due elenchi, ordinata in modo che le lingue preferite dall'utente siano elencate per prime.

Se questa caratteristica 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.

Parametri

Elementi API correlati

Restituisce un oggetto contenente tutte le coppie di chiavi e valori dall'oggetto LocaleID.

L'oggetto restituito è strutturato come una tabella hash o un array associativo, in cui ogni nome di proprietà rappresenta una chiave e il valore della proprietà corrisponde al valore per tale chiave. Il codice seguente, ad esempio, elenca tutte le chiavi e i valori ottenuti dall'oggetto LocaleID tramite il metodo getKeysAndValues():

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

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.

Elementi API correlati

Restituisce il codice della lingua specificato dal nome dell'ID di impostazioni internazionali.

Se il nome delle impostazioni internazionali non può essere analizzato correttamente, il codice della lingua corrisponde al nome completo delle impostazioni internazionali.

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.

Elementi API correlati

Restituisce il codice di area specificato dal nome dell'ID di impostazioni internazionali.

Questo metodo restituisce una stringa vuota se il codice di area non può essere analizzato o determinato. Questa situazione può verificarsi se viene utilizzato un nome dell'ID di impostazioni internazionali sconosciuto o incompleto, quale "xy". Il codice di area non viene convalidato rispetto a un elenco fisso. Ad esempio, il codice di area restituito per il nome di un ID di impostazioni internazionali "xx-YY" è "YY".

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

• LastOperationStatus.NO_ERROR

Se il codice di area non fa parte del nome delle impostazioni internazionali specificato, viene individuato il codice di area più probabile e la proprietà lastOperationStatus viene impostata su LastOperationStatus.USING_FALLBACK_WARNING

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

Elementi API correlati

Restituisce il codice di script specificato dal nome dell'ID di impostazioni internazionali.

Questo metodo restituisce una stringa vuota se il codice di script non può essere analizzato o determinato. Questa situazione può verificarsi se viene utilizzato un nome dell'ID di impostazioni internazionali sconosciuto o incompleto, quale "xy". Il codice di script non viene convalidato rispetto a un elenco fisso. Ad esempio, il codice di script restituito per un nome dell'ID di impostazioni internazionali "xx-Abcd-YY" è "Abcd".

Anche l'area geografica, oltre che la lingua, può determinare il valore restituito. Ad esempio, il codice di script per "mn-MN" (mongolo - Mongolia) è "Cyrl" (cirillico), mentre il codice di script per "mn-CN" (mongolo - Cina) è "Mong" (mongolo).

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

• LastOperationStatus.NO_ERROR

Se il codice di script non fa parte del nome delle impostazioni internazionali specificato, viene individuato il codice di script più probabile e la proprietà lastOperationStatus viene impostata su LastOperationStatus.USING_FALLBACK_WARNING

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

Elementi API correlati

Restituisce il codice della variante linguistica specificato dal nome dell'ID di impostazioni internazionali.

Questo metodo restituisce una stringa vuota se nel nome dell'ID di impostazioni internazionali specificato non è presente un codice della variante linguistica. (Non sono necessarie supposizioni, in quanto sono poche le impostazioni internazionali che dispongono o necessitano di una variante linguistica).

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.

Elementi API correlati

Specifica se la direzione del testo per le impostazioni internazionali specificate è da destra a sinistra.

Il risultato può essere utilizzato per determinare la direzione del testo nel motore di testo di Flash e per decidere se all'interfaccia utente deve essere applicato un layout speculare per supportare la direzione del testo corrente.

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.

Elementi API correlati

Indica se devono essere utilizzate le preferenze linguistiche predefinite dell'utente, secondo quanto specificato nelle impostazioni del sistema operativo dell'utente. Tali preferenze, ad esempio, vengono solitamente impostate tramite il Pannello di controllo di Windows o le Preferenze di Sistema in Mac OS X.

L'utilizzo dell'impostazione LocaleID.DEFAULT può comportare l'utilizzo di un nome dell'ID di impostazioni internazionali diverso per diversi tipi di operazioni. Ad esempio, potrebbe essere utilizzato un nome di impostazioni internazionali per l'ordinamento e uno diverso per la formattazione. Con questo approccio flessibile vengono rispettate le preferenze dell'utente, e la classe è progettata per seguire questo comportamento.

Questo identificatore di impostazioni internazionali non è sempre quello di uso più appropriato. Per le applicazioni eseguite nel browser, le impostazioni internazionali preferite del browser potrebbero rappresentare la scelta migliore. È spesso buona norma consentire all'utente di modificare l'impostazione del nome dell'ID di impostazioni internazionali e mantenere tale preferenza in un profilo utente, un cookie o un oggetto condiviso.

In questo esempio vengono utilizzate le seguenti impostazioni internazionali: arabo (Arabia Saudita), inglese (Stati Uniti), inglese (Stati Uniti, variante POSIX), cinese (Repubblica popolare cinese), cinese (Taiwan), cinese (script Han semplificato), cinese (Repubblica popolare cinese con diversi valori e chiavi).

Nell'esempio vengono effettuate le seguenti operazioni per ogni contesto di impostazioni internazionali incluso nell'elenco:

1. Crea un nuovo oggetto LocaleID.
2. Visualizza varie proprietà dell'oggetto LocaleID. I valori visualizzati saranno diversi a seconda del sistema operativo in uso e delle preferenze dell'utente.
3. Visualizza l'intera serie di chiavi e di valori per l'oggetto 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);
            }
        }
    }
}