Skip to content

Latest commit

 

History

History
93 lines (68 loc) · 3.01 KB

nf-winuser-flashwindow.md

File metadata and controls

93 lines (68 loc) · 3.01 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:winuser.FlashWindow
FlashWindow function (winuser.h)
Flashes the specified window one time. It does not change the active state of the window.
FlashWindow
FlashWindow function
_win32_flashwindow
base.flashwindow
winuser/FlashWindow
base\flashwindow.htm
Debug
c4af997d-5cb8-4d5d-ae8d-1e0cc724fe02
12/05/2018
FlashWindow, FlashWindow function, _win32_flashwindow, base.flashwindow, winuser/FlashWindow
winuser.h
Windows.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
User32.lib
User32.dll
Windows
19H1
FlashWindow
winuser/FlashWindow
c++
APIRef
kbSyntax
DllExport
User32.dll
FlashWindow

FlashWindow function

-description

Flashes the specified window one time. It does not change the active state of the window.

To flash the window a specified number of times, use the FlashWindowEx function.

-parameters

-param hWnd [in]

A handle to the window to be flashed. The window can be either open or minimized.

-param bInvert [in]

If this parameter is TRUE, the window is flashed from one state to the other. If it is FALSE, the window is returned to its original state (either active or inactive).

When an application is minimized and this parameter is TRUE, the taskbar window button flashes active/inactive. If it is FALSE, the taskbar window button flashes inactive, meaning that it does not change colors. It flashes, as if it were being redrawn, but it does not provide the visual invert clue to the user.

-returns

The return value specifies the window's state before the call to the FlashWindow function. If the window caption was drawn as active before the call, the return value is nonzero. Otherwise, the return value is zero.

-remarks

Flashing a window means changing the appearance of its caption bar as if the window were changing from inactive to active status, or vice versa. (An inactive caption bar changes to an active caption bar; an active caption bar changes to an inactive caption bar.)

Typically, a window is flashed to inform the user that the window requires attention but that it does not currently have the keyboard focus.

The FlashWindow function flashes the window only once; for repeated flashing, the application should create a system timer.

-see-also

Error Handling Functions

Notifying the User