FlashWindow 函数 (winuser.h)

将指定的窗口闪烁一次。 它不会更改窗口的活动状态。

若要闪烁指定次数的窗口,请使用 FlashWindowEx 函数。

语法

BOOL FlashWindow(
  [in] HWND hWnd,
  [in] BOOL bInvert
);

参数

[in] hWnd

要闪烁的窗口的句柄。 窗口可以打开或最小化。

[in] bInvert

如果此参数为 TRUE,则窗口将从一种状态闪烁到另一种状态。 如果为 FALSE,则窗口将返回到其原始状态 (活动或非活动) 。

当应用程序最小化且此参数为 TRUE 时,任务栏窗口按钮将闪烁活动/非活动状态。 如果为 FALSE,任务栏窗口按钮将闪烁非活动状态,这意味着它不会更改颜色。 它闪烁,就像正在重绘一样,但它没有向用户提供视觉反转线索。

返回值

返回值指定在调用 FlashWindow 函数之前窗口的状态。 如果窗口标题在执行该调用之前绘制为活动状态,则返回值不为零。 否则返回值为零。

注解

闪烁窗口意味着更改其描述文字栏的外观,就像窗口从非活动状态更改为活动状态,反之亦然。 (非活动描述文字栏更改为活动描述文字栏;活动描述文字栏更改为非活动描述文字栏。)

通常,会闪烁一个窗口,通知用户该窗口需要注意,但它当前没有键盘焦点。

FlashWindow 函数仅闪烁一次窗口;对于重复闪烁,应用程序应创建系统计时器。

要求

要求
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll

另请参阅

错误处理函数

通知用户