LocaleID  - AS3

O status da operação mais recente que este objeto LocaleID 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

Retorna um identificador de local ligeiramente mais "canônico".

Este método executa a seguinte conversão à ID de localidade para oferecer uma forma mais canônica.

• A cobertura própria é aplicada a todos os componentes.
• Os sublinhados são convertidos para traços.

Nenhum processamento adicional é executado. Por exemplo, os pseudônimos não são substituídos, e nenhum elemento é adicionado ou retirado.

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.

Constrói um novo objeto LocaleID, considerando um nome de local. O nome de localidade deve ajustar com a sintaxe definida pelo Padrão Técnico Unicode #35 (http://unicode.org/reports/tr35/).

Quando o construtor conclui com sucesso o lastOperationStatus a propriedade é definida como:

• 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.

Para ver detalhes sobre os avisos citados acima e outros valores possíveis da propriedade lastOperationStatus, consulte as descrições na classe LastOperationStatus.

Elementos da API relacionados

Retorna uma lista de localidades aceitáveis com base em uma lista de localidades desejadas e uma lista das localidades que estão atualmente disponíveis.

A lista resultante é classificada segundo a ordem da preferência.

Veja um caso típico de uso deste método:

• Um usuário especifica uma lista de idiomas que entende (armazenada em um perfil de usuário, em uma configuração de navegador ou em um cookie). O usuário enumera primeiro os idiomas que entende melhor, de modo que a ordem dos idiomas na lista é relevante. Esta é a lista "querer".
• O aplicativo é localizado em um número de idiomas diferentes. Esta é a lista "ter".
• O método determinePreferredLocales() retorna uma intersecção das duas listas, classificadas para que os idiomas preferenciais do usuário venham primeiro.

Se este recurso não for suportado 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.

Parâmetros

Elementos da API relacionados

Retorna um objeto que contém todos os os pares de chave e valor do objeto de LocaleID.

O objeto retornado é estruturado como uma tabela aleatório ou matriz associativa, onde cada nome da propriedade representa uma chave e o valor da propriedade é o valor daquela chave. Por exemplo, os códigos a seguir listam todas as chaves e valores obtidos do objeto LocaleID usando o 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]);
         }
         

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.

Elementos da API relacionados

Retorna o código de idioma especificado pelo nome de ID de localidade.

Se o nome do idioma não puder ser analisado adequadamente, o código de idioma será igual ao nome completo do idioma.

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.

Elementos da API relacionados

Retorna o código da região especificada pelo nome de ID de localidade.

Este método retorna uma cadeia vazia se o código de região não puder ser analisado ou adivinhou que Isto pode ocorrer se uma localidade desconhecida ou incompleta nome de ID como "xy" é usada. O código de região não é validado em relação a uma lista fixa. Por exemplo, o código de região retornado para um nome de ID de idioma "xx-YY" será "YY".

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

• LastOperationStatus.NO_ERROR

Se a região não for parte do nome de localidade especificado, o código de região mais provável da localidade será "adivinhado" e a propriedade lastOperationStatus a será definida como LastOperationStatus.USING_FALLBACK_WARNING

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

Elementos da API relacionados

Retorna o código de script especificado pela nome de ID de localidade.

Este método retorna uma cadeia vazia se o código de script não puder ser analisado ou adivinhou que Isto pode ocorrer se uma localidade desconhecida ou incompleta nome de ID como "xy" é usada. O código de script não é validado em relação a uma lista fixa. Por exemplo, o código de script retornado para um nome de ID de idioma "xxAbcd-YY" será "Abcd".

A região, assim como o idioma, também pode afetar o valor de retorno. Por exemplo o código de script para "mn-MN" (Mongol-Mongólia) será "Cyrl" (Cirílico), enquanto o código de script para "mn-CN" (Mongol-China) será "Mong" (Mongol).

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

• LastOperationStatus.NO_ERROR

Se o código de script não for parte do nome de localidade especificado, o código de script mais provável é "adivinhado" e a propriedade lastOperationStatus será definida como LastOperationStatus.USING_FALLBACK_WARNING.

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

Elementos da API relacionados

Retorna o código de variante de idioma especificado pelo nome de ID de localidade.

Este método retorna uma cadeia vazia se não houver nenhum código de variante de idioma na localidade dada o nome de ID. (Nenhuma suposição é necessária, porque poucos idiomas têm ou uma variante de idioma ou precisam dela.)

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.

Elementos da API relacionados

Especifica se a direção de texto para a localidade especificada é da direita para a esquerda.

O resultado pode ser usado para determinar a direção do texto no mecanismo de texto do Flash e decidir se a interface do usuário deve ser espelhada para suportar a direção de texto atual.

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.

Elementos da API relacionados

Indica que as preferências linguísticas padrão do usuário devem ser usadas, conforme o especificado nas configurações do sistema operacional do usuário. Por exemplo, tais preferências são normalmente estabelecidas usando "Painel de controle" do Windows, ou "Preferências do Sistema" no Mac OSX.

O uso da definição LocaleID.DEFAULT pode resultar no uso de um nome de ID de localidade para diferentes espécies de operações. Por exemplo, um idioma poderia ser usado para a classificação. e outro para a formatação. Esta flexibilidade respeita as preferências do usuário e se comporta dessa maneira por definição do projeto.

Este identificador de localidade não é sempre o mais apropriado para usar. Para aplicativos que executam no navegador, o idioma preferido do navegador poderia ser uma melhor escolha. Geralmente, é recomendável permitir que o usuário altere a configuração de nome de ID de idioma preferida e preservar a preferência em um perfil do usuário, cookie ou objeto compartilhado.

Este exemplo usa as seguintes idiomas: o arábico (Arábia saudita), inglês (EUA), inglês (EUA, variante POSIX), chinês (PRC), chinês (Taiwan), chinês (Script Han Simplificado), chinês (PRC e várias chaves e valores)

O exemplo realiza o seguinte para cada idioma na lista:

1. Cria um novo objeto CameraRollBrowseOptions.
2. Exibe várias propriedades do LocaleID. Os valores mostrados vão se diferenciar baseados no seu sistema operacional e preferências de usuário.
3. Exibe o conjunto completo de chaves e valores do 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);
            }
        }
    }
}