Multilingual User Interface (MUI) Registry Settings

Artigo
08/12/2009

Windows Mobile Not Supported Windows Embedded CE Supported

9/8/2008

A seguinte tabela mostra as configurações Registro para a HKEY_CURRENT_USER\MUI chave Registro.

Valor : tipo	Descrição
CurLang: REG_DWORD	Especifica o identificador linguagem (LCID) para o atual usuário.
Ativar : REG_DWORD	Padrão definido como 1. Definir esse valor para 1 Ativa MUI a executar-imagem tempo; configuração esse valor para 0 desativa MUI a executar-imagem tempo.
SysLang: REG_DWORD	Nenhuma usar como padrão será definida. Especifica o identificador linguagem sistema usar como padrão (LCID).

Registro MUI

O Registro MUI permite que você armazenar seqüências de caracteres localizável. Essas seqüências de caracteres tradicionalmente foram armazenadas na seção de recurso de um aplicável módulo, such as uma .dll ou um arquivo .exe. Esse mecanismo amplia a funcionalidade do MUI Catalog item. O Registro MUI permite que você tiver um entrada do Registro que aponta para várias seqüências de caracteres localizadas com o ativo valor sendo baseia a atual Configurações localidade.

Para criar uma entrada Registro para um seqüência de caracteres localizável

Usando Bloco de Notas, aberto o arquivo .reg onde as configurações Registro o aplicável módulo estão armazenados.
Crie uma entrada do tipo REG_MUI_SZ para cada seqüência de caracteres Registro. Cada entrada Registro deve lista o módulo contendo o de conteúdo localizado e o identificação do recurso da seqüência de caracteres. Use a seguinte sintaxe:
```
"ValueName"=mui_sz:"<dll name>, #<resource id>"
```
De exemplo, para criar uma entrada Registro para o versão localizada do seqüência de caracteres "pasta", adicionar a seguinte entrada Registro para o arquivo. reg:
```
"Folder"=mui_sz:"MySample.dll,#20"
```

Definindo o valor como MySample.dll,#20 implica que a versão localizada do seqüência de caracteres é armazenado como recurso #20 no módulo de MySample.dll.

Para recuperar o valor de uma seqüência de caracteres localizados a partir de Registro, um aplicativo deve chamar o RegQueryValueEx ou RegEnumValue funções. Localizar automaticamente o Registro será o apropriado módulo MUI, carregar o seqüência de caracteres e devolvê-lo para o aplicativo. O tipo Registro será definido como REG_SZ no retorno de chamar a função.

Para substituir um valor do Registro existente, um aplicativo deve chamar a função RegSetValueEx. Substituindo o valor REG_MUI_SZ com um valor de tipo REG_SZ irá substituir o valor do Registro MUI com a constante especificada valor do Registro. Esse novo valor será aplicada a todas as configurações localidade.

Para ler o formatado seqüência de caracteres de especificação MUI que tenha sido especificada no Registro, um aplicativo deve predefinida o tipo de valor para REG_MUI_SZ antes chamado RegQueryValueEx. A alteração da especificação MUI, um aplicativo também pode definir o tipo de valor para REG_MUI_SZ quando ele chama RegSetValueEx. Você deve formato o valor do Registro usando o apropriado sintaxe descrito em Step 2.

Observação

O método Registro MUI não pode aplicar a determinados elementos, such as área de trabalho seqüência de caracteres localizável atalhos e nomes driver.

O seguinte codificar amostras demonstrar o uso correto dos tipos quando criar a chave, criando um valor, consultar o valor e carregando seqüência de caracteres o recurso. O apontar desse exemplo é para demonstrar que você deve tratar o objeto REG_MUI_SZ como uma chave Registro normal. Se você definir o parâmetro tipo para REG_MUI_SZ, o recurso não será carregado.

O seguinte exemplo mostra como criar ou aberto a chave Registro onde um valor REG_MUI_SZ será armazenado usando RegCreateKeyEx.

HKEY OpenedKey = NULL;
DWORD CreationDisposition = 0;

LONG lReturn = RegCreateKeyEx(
    HKEY_LOCAL_MACHINE, 
    L"\\NewKey\\", 
    0,
    NULL,
    0,
    0,
    NULL,
    &OpenedKey,
    &CreationDisposition);

O valor de lReturn deve ser ERROR_SUCCESS se tudo o que foi criado corretamente.

O seguinte amostra de código demonstra como criar um valor REG_MUI_SZ, após criar a chave Registro acima SO as to definido OpenedKey. Observe que o Tipo parâmetro está definido como REG_MUI_SZ.

DWORD DataSize = 0;
StringCbLength(L"regmui.dll,#1001", MAX_PATH, (size_t *)&DataSize)

LONG lReturn = RegSetValueEx(
    OpenedKey, 
    L"RegMuiExample", 
    0,
    REG_MUI_SZ,
    (BYTE *)L"regmui.dll,#1001",
    DataSize);

O seguinte amostra de código demonstra como a consulta a seqüência de caracteres REG_MUI_SZ que acabou de foi definido. Novamente, o Tipo parâmetro está definido como REG_MUI_SZ.

DWORD Type = REG_MUI_SZ;
LPWSTR DataBuffer = (LPWSTR)LocalAlloc(LPTR, MAX_PATH);
LONG lReturn = RegQueryValueEx (
    OpenedKey, 
    L"RegMuiExample", 
    0,
    &Type, 
    (BYTE *)DataBuffer,
    &DataSize);

Finalmente, a seguinte amostra de código demonstra como para carregar o seqüência de caracteres recurso definido nos exemplos anteriores. Observe que neste chamar, o Tipo parâmetro está definido como 0.

DWORD Type = 0;
LONG Return = RegQueryValueEx (
    OpenedKey, 
    L"RegMuiExample", 
    0,
    &Type, 
    (BYTE *)DataBuffer,
    &DataSize);

Multilingual User Interface (MUI) Registry Settings

Registro MUI

See Also

Other Resources

Recursos adicionais