Freigeben über


FlashWindow-Funktion (winuser.h)

Lässt das angegebene Fenster einmal blinken. Der aktive Status des Fensters wird nicht geändert.

Verwenden Sie die FlashWindowEx-Funktion , um das Fenster mehrmals zu blinken.

Syntax

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

Parameter

[in] hWnd

Ein Handle für das zu blinkende Fenster. Das Fenster kann entweder geöffnet oder minimiert sein.

[in] bInvert

Wenn dieser Parameter TRUE ist, wird das Fenster von einem Zustand zum anderen geblitzt. Wenn es FALSE ist, wird das Fenster in seinen ursprünglichen Zustand (entweder aktiv oder inaktiv) zurückgegeben.

Wenn eine Anwendung minimiert wird und dieser Parameter TRUE ist, blinkt die Schaltfläche des Taskleistenfensters aktiv/inaktiv. Wenn es FALSE ist, blinkt die Schaltfläche des Taskleistenfensters inaktiv, was bedeutet, dass die Farben nicht geändert werden. Es blinkt, als ob es neu gezeichnet würde, aber es liefert dem Benutzer nicht den visuellen Inverthinweis.

Rückgabewert

Der Rückgabewert gibt den Status des Fensters vor dem Aufruf der FlashWindow-Funktion an. Wenn das Fenster Untertitel vor dem Aufruf als aktiv gezeichnet wurde, ist der Rückgabewert ungleich null. Andernfalls ist der Rückgabewert null.

Hinweise

Das Blinken eines Fensters bedeutet, dass das Erscheinungsbild des Untertitel Balkens so geändert wird, als ob das Fenster von inaktiv zu aktivem status wechseln würde oder umgekehrt. (Ein inaktiver Untertitel Balken wird in einen aktiven Untertitel-Balken geändert. Ein aktiver Untertitel Balken wird in einen inaktiven Untertitel-Balken geändert.)

In der Regel wird ein Fenster geblitzt, um den Benutzer darüber zu informieren, dass das Fenster Aufmerksamkeit erfordert, aber derzeit nicht über den Tastaturfokus verfügt.

Die FlashWindow-Funktion blinkt das Fenster nur einmal; Für wiederholtes Blinken sollte die Anwendung einen Systemtimer erstellen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile winuser.h (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll

Weitere Informationen

Fehlerbehandlungsfunktionen

Benachrichtigen des Benutzers