FlashWindow 関数 (winuser.h)
指定したウィンドウを 1 回点滅させます。 ウィンドウのアクティブな状態は変更されません。
指定した回数だけウィンドウをフラッシュするには、 FlashWindowEx 関数を使用します。
構文
BOOL FlashWindow(
[in] HWND hWnd,
[in] BOOL bInvert
);
パラメーター
[in] hWnd
フラッシュするウィンドウのハンドル。 ウィンドウは開くか最小化できます。
[in] bInvert
このパラメーターが TRUE の場合、ウィンドウは一方の状態から他方の状態にフラッシュされます。 FALSE の場合、ウィンドウは元の状態 (アクティブまたは非アクティブ) に返されます。
アプリケーションが最小化され、このパラメーターが TRUE の場合、タスク バー ウィンドウ ボタンがアクティブまたは非アクティブで点滅します。 FALSE の場合、タスク バー ウィンドウ ボタンは非アクティブで点滅します。つまり、色は変更されません。 再描画されているかのように点滅しますが、視覚的な反転の手掛かりはユーザーに提供されません。
戻り値
戻り値は、 FlashWindow 関数の呼び出し前のウィンドウの状態を指定します。 呼び出しの前にウィンドウ キャプションがアクティブとして描画された場合、戻り値は 0 以外です。 それ以外の場合、戻り値は 0 です。
注釈
ウィンドウを点滅させるということは、ウィンドウが非アクティブ状態からアクティブ状態に変わっていたかのように、そのキャプションバーの外観を変更することを意味します。その逆も同様です。 (非アクティブなキャプション バーがアクティブなキャプション バーに変わり、アクティブなキャプション バーが非アクティブなキャプション バーに変わります)。
通常、ウィンドウはフラッシュされ、ウィンドウには注意が必要ですが、現在はキーボード フォーカスがないことをユーザーに通知します。
FlashWindow 関数は、ウィンドウを 1 回だけフラッシュします。フラッシュを繰り返す場合は、アプリケーションでシステム タイマーを作成する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |