Home Library Learn Downloads Support Community
Sign in | United States - English | |
7 out of 7 rated this helpful - Rate this topic

FLASHWINFO structure

Applies to: desktop apps only

Contains the flash status for a window and the number of times the system should flash the window.

Syntax

Copy 
typedef struct {
  UINT  cbSize;
  HWND  hwnd;
  DWORD dwFlags;
  UINT  uCount;
  DWORD dwTimeout;
} FLASHWINFO, *PFLASHWINFO;

Members

cbSize

The size of the structure, in bytes.

hwnd

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

dwFlags

The flash status. This parameter can be one or more of the following values.

ValueMeaning
FLASHW_ALL
0x00000003

Flash both the window caption and taskbar button. This is equivalent to setting the FLASHW_CAPTION | FLASHW_TRAY flags.

FLASHW_CAPTION
0x00000001

Flash the window caption.

FLASHW_STOP
0

Stop flashing. The system restores the window to its original state.

FLASHW_TIMER
0x00000004

Flash continuously, until the FLASHW_STOP flag is set.

FLASHW_TIMERNOFG
0x0000000C

Flash continuously until the window comes to the foreground.

FLASHW_TRAY
0x00000002

Flash the taskbar button.

 

uCount

The number of times to flash the window.

dwTimeout

The rate at which the window is to be flashed, in milliseconds. If dwTimeout is zero, the function uses the default cursor blink rate.

Requirements

Minimum supported client

Windows XP

Minimum supported server

Windows Server 2003

Header
Winuser.h (include Windows.h)

See also

FlashWindowEx

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012

Did you find this helpful?
(1500 characters remaining)
Community Content Add
Annotations FAQ
Possible bug with FLASHW_STOP and Windows 7
I have Win7 64bit SP1 - not sure about other platforms If FlashWindowEx is called with only the FLASHW_STOP set, you might expect that uCount and dwTimeout would be ignored. However, if the window is not the foreground window when FlashWindowEx is called, the program's application button in the tool tray will suddenly turn orange after the combination of uCount and dwTimeout expires. For example, I had uCount set to 5 and dwCount set to 1000, and the taskbar icon turned orange after about 5 seconds. This occurs even if your application only ever calls FlashWindowEx() once, with FLASHW_STOP, 5, 1000, for example. Setting both uCount and dwTimeout to zero when using the FLASHW_STOP flag seems to solve this issue.
History
FLASHWINFO
typedef struct {
UINT cbSize;
HWND hwnd;
DWORD dwFlags;
UINT uCount;
DWORD dwTimeout;
} FLASHWINFO, *PFLASHWINFO
History
HRESULT GetComparisonData(
HRESULT GetComparisonData(
  [out]  byte *pbData,
  [in]   ULONG cbMax,
  [out]  ULONG *pcbData
);HRESULT GetComparisonData(
  [out]  byte *pbData,
  [in]   ULONG cbMax,
  [out]  ULONG *pcbData
);
History