SetForegroundWindow

指定されたウィンドウを作成したスレッドをフォアグラウンドにし、ウィンドウをアクティブ化する。

SetForegroundWindow hWnd

hWnd : [intptr] 型: HWND アクティブ化してフォアグラウンドに持ってくるウィンドウへのハンドル。

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

解説

指定されたウィンドウを作成したスレッドをフォアグラウンドにし、ウィンドウをアクティブ化する。

[戻り値]
型: BOOL ウィンドウがフォアグラウンドになった場合は 0 以外、そうでない場合は 0。

[備考]
システムはフォアグラウンドウィンドウを設定できるプロセスを制限する。SetForegroundWindow
を呼び出してフォアグラウンドウィンドウを設定できるのは、呼び出し元プロセスがデスクトップアプリケーション(UWP や Windows
Store アプリではない)、LockSetForegroundWindow
で呼び出しが無効化されていない、フォアグラウンドロックタイムアウト経過済み、アクティブなメニューがない、かつ以下のいずれかを満たす場合:
呼び出しプロセスがフォアグラウンド、呼び出しプロセスがフォアグラウンドから起動された、フォアグラウンドウィンドウがない、最後の入力イベントを受信した、呼び出しプロセスまたはフォアグラウンドプロセスがデバッグ中。ユーザが他のウィンドウを操作している間はウィンドウを強制的にフォアグラウンドにすることはできず、代わりにタスクバーボタンが点滅する。
(以下省略)

情報

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