SetThreadLocale

呼び出し側スレッドの現在のロケールを設定する。

SetThreadLocale Locale

Locale : [int] ロケールを指定するロケール識別子。MAKELCID マクロでロケール識別子を作成するか、定義済みの値を使用する。

(プラグイン / モジュール : kernel32.dll)

解説

呼び出し側スレッドの現在のロケールを設定する。

[戻り値]
成功した場合は LCID を返すべきである。これは直前のスレッドロケールの LCID である。

[備考]
スレッドが作成されたとき、スレッドはユーザーロケールを使う。この値は GetUserDefaultLCID
が返す。ユーザーロケールはコントロールパネルの地域と言語のオプションで以後のプロセスとスレッド作成のために変更できる。スレッドロケールも
SetThreadLocale で変更できる。SetThreadLocale は LANGUAGE
文を伴うリソースの選択に影響する。CreateDialog、DialogBox、LoadMenu、LoadString、FindResource
などに影響し、CP_THREAD_ACP が暗黙する CP も設定するが、FindResourceEx には影響しない。詳細は Code
Page Identifiers を参照。Windows Vista 以降: ユーザーインターフェース言語を選択するのに
SetThreadLocale を使ってはならない。リソースローダは .rc で LANGUAGE
文により定義されたリソースを選択するか、アプリケーションが FindResourceEx を使用できる。さらに
SetThreadUILanguage も使える。Windows 2000、Windows XP: SetThreadLocale を
UI 言語選択に使ってはならない。.rc の LANGUAGE 文で定義されたリソースを選択するには FindResourceEx
を使う必要がある。

情報

プラグイン / モジュールkernel32.dll
バージョン1.0
作成日2026/04/16
著作者IronHSP / CsWin32 bridge
URLhttps://github.com/inovia/IronHSP
備考Win32 API の kernel32.dll 関数群。CsWin32 + win32metadata から自動生成。
hsp3net 専用 (intptr / NSTRUCT / wstr を使用)。
タイプ拡張命令
グループWin32API
対応環境
  • Windows 版 HSP
hs ファイルhsphelp\win32_kernel32_gen2.hs