FlashWindowEx function (winuser.h)

Flashes the specified window. It does not change the active state of the window.

Syntax

BOOL FlashWindowEx(
  [in] PFLASHWINFO pfwi
);

Parameters

[in] pfwi

A pointer to a FLASHWINFO structure.

Return value

The return value specifies the window's state before the call to the FlashWindowEx function. If the window caption was drawn as active before the call, the return value is nonzero. Otherwise, the return value is zero.

Remarks

Typically, you flash a window to inform the user that the window requires attention but does not currently have the keyboard focus. When a window flashes, it appears to change from inactive to active status. An inactive caption bar changes to an active caption bar; an active caption bar changes to an inactive caption bar.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll
API set ext-ms-win-ntuser-misc-l1-5-0 (introduced in Windows 10, version 10.0.10240)

See also

Error Handling Functions

FLASHWINFO

Notifying the User