FlashWindowEx function
Advanced GDI routines Example
Return to Introduction  Previous page  Next page

function FlashWindowEx(  
  fwi: FLASHWINFO // flash status information   
): BOOL;  

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

fwi   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.  

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.  

Windows NT/2000: Requires Windows 2000 or later.  
Windows 95/98: Requires Windows 98 or later.  
tip If you call this function on Win95/NT4 — nothing happends.  

See also
FLASHWINFO structure and usage example.  
acFlashWindow procedure.  
acWin2kEffects component.