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

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

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

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

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