FlashWindowEx

[This is preliminary documentation and subject to change.]

The FlashWindowEx function flashes the specified window. Using this function, you can specify the number of times the system will flash the window, whereas the FlashWindow function flashes the window only once.

BOOL FlashWindowEx(
  PFLASHWINFO pfwi
);
 

Parameters

pfwi
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 was active before the call, the return value is nonzero.

If the window was not active before the call, 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.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98 or later.
  Windows CE: Unsupported.
  Header: Declared in winuser.h.
  Import Library: Use user32.lib.

See Also

Errors Overview, Error Functions, FLASHWINFO