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

Confira também

GetSystemDefaultLCID

GetThreadLocale

GetUserDefaultLCID

Suporte a idiomas nacionais

Funções de suporte à linguagem nacional