FlashWindowEx

The FlashWindowEx function flashes the specified window. It does not change the active state of the window.

BOOL FlashWindowEx(
  PFLASHWINFO pfwi  // flash status information
);

Parameters

pfwi

[in] Pointer to the FLASHWINFO structure.

Return Values

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

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Header: Declared in Winuser.h; include Windows.h.
  Library: Use User32.lib.

See Also

Error Handling Overview, Error Handling Functions, FLASHWINFO