Função SetThreadLocale (winnls.h)
Define a localidade atual do thread de chamada.
Sintaxe
BOOL SetThreadLocale(
[in] LCID Locale
);
Parâmetros
[in] Locale
Identificador de localidade que especifica a localidade. Você pode usar a macro MAKELCID para criar um identificador de localidade ou usar um dos valores predefinidos a seguir.
- LOCALE_CUSTOM_DEFAULT
- LOCALE_CUSTOM_UI_DEFAULT
- LOCALE_CUSTOM_UNSPECIFIED
- LOCALE_INVARIANT
- LOCALE_SYSTEM_DEFAULT
- LOCALE_USER_DEFAULT
Valor retornado
A função deve retornar um LCID em caso de êxito. Esse é o LCID da localidade do thread anterior.
Comentários
Quando um thread é criado, ele usa a localidade do usuário. Esse valor é retornado por GetUserDefaultLCID. A localidade do usuário pode ser modificada para processos futuros e criação de threads usando a parte de opções regionais e de idioma do Painel de Controle. A localidade do thread também pode ser alterada usando SetThreadLocale.
SetThreadLocale afeta a seleção de recursos com uma instrução LANGUAGE . A instrução afeta funções como CreateDialog, DialogBox, LoadMenu, LoadString e FindResource. Ele define a página de código implícita por CP_THREAD_ACP, mas não afeta FindResourceEx. Para obter mais informações, consulte Identificadores de página de código.
Windows Vista e posterior: Não use SetThreadLocale para selecionar um idioma de interface do usuário. O carregador de recursos seleciona o recurso definido no arquivo .rc com uma instrução LANGUAGE ou o aplicativo pode usar FindResourceEx. Além disso, o aplicativo pode usar SetThreadUILanguage.
Windows 2000, Windows XP: Não use SetThreadLocale para selecionar um idioma de interface do usuário. Para selecionar o recurso definido no arquivo .rc com uma instrução LANGUAGE , o aplicativo deve usar a função FindResourceEx .
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | winnls.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |