SetActiveWindow 関数 (winuser.h)

ウィンドウをアクティブにします。 ウィンドウは、呼び出し元スレッドのメッセージ キューにアタッチされる必要があります。

構文

HWND SetActiveWindow(
  [in] HWND hWnd
);

パラメーター

[in] hWnd

型: HWND

アクティブ化する最上位ウィンドウへのハンドル。

戻り値

型: HWND

関数が成功した場合、戻り値は、以前にアクティブだったウィンドウへのハンドルです。

関数が失敗した場合は、返される値は NULL です。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

SetActiveWindow 関数はウィンドウをアクティブにしますが、アプリケーションがバックグラウンドにある場合はアクティブになりません。 システムがウィンドウをアクティブ化するときに、アプリケーションがフォアグラウンドにある場合、ウィンドウはフォアグラウンド ( Z オーダーの先頭) に表示されます。

hWnd パラメーターによって識別されたウィンドウが呼び出し元のスレッドによって作成された場合、呼び出し元スレッドのアクティブなウィンドウの状態は hWnd に設定されます。 それ以外の場合、呼び出し元スレッドのアクティブウィンドウの状態は NULL に設定されます。

要件

サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	winuser.h (Windows.h を含む)
Library	User32.lib
[DLL]	User32.dll
API セット	ext-ms-win-ntuser-window-l1-1-4 (Windows 10 バージョン 10.0.14393 で導入)

関連項目

概念

GetActiveWindow

キーボード入力

リファレンス

SetForegroundWindow

WM_ACTIVATE