Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINFRAMEMGR
 
BOOL WinFlashWindow(hwndFrame, fFlash)
HWND hwndFrame;    /* handle of the window to flash */
BOOL fFlash;       /* start/stop flashing flag      */
 
The WinFlashWindow function starts or stops flashing a window. Flashing is
achieved by inverting the title bar continuously. A beep is emitted for the
first five flashes. If the window has been minimized, the icon text will
flash when this function is called.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hwndFrame  Identifies the window to flash.
 
fFlash     Specifies whether the window flashes. If TRUE, the window starts
           flashing. If FALSE, the window stops flashing.
 
Return Value
 
The return value is TRUE if the function is successful or FALSE if an error
occurs.
 
Comments
 
If an application needs to display a message box, but it does not have the
focus, then it should call the WinFlashWindow function to flash its frame
window and emit a beep to get the user's attention. Once it receives the
focus, it can call WinFlashWindow again to stop the flashing, and then
display its message box. By using this method, a message box from your
application will not be displayed while the user is working with another
application.
 
See Also
 
WinAlarm
 
                                      ♦