Funzione FlashWindow (winuser.h)

Lampeggia la finestra specificata una volta. Non modifica lo stato attivo della finestra.

Per flashare la finestra un numero specificato di volte, usare la funzione FlashWindowEx .

Sintassi

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

Parametri

[in] hWnd

Handle per la finestra da flashare. La finestra può essere aperta o ridotta a icona.

[in] bInvert

Se questo parametro è TRUE, la finestra viene lampeggiata da uno stato all'altro. Se è FALSE, la finestra viene restituita allo stato originale (attivo o inattivo).

Quando un'applicazione viene ridotta a icona e questo parametro è TRUE, il pulsante della finestra della barra delle applicazioni lampeggia attivo/inattivo. Se è FALSE, il pulsante della finestra della barra delle applicazioni lampeggia inattivo, significa che non cambia i colori. Lampeggia, come se fosse stato ridisegnato, ma non fornisce l'indizio visivo invertito all'utente.

Valore restituito

Il valore restituito specifica lo stato della finestra prima della chiamata alla funzione FlashWindow . Se la finestra didascalia è stata disegnata come attiva prima della chiamata, il valore restituito è diverso da zero. In caso contrario, il valore restituito è zero.

Commenti

Il flashing di una finestra significa modificare l'aspetto della barra didascalia come se la finestra cambiasse da inattiva allo stato attivo o viceversa. Una barra di didascalia inattiva viene modificata in una barra di didascalia attiva; una barra didascalia attiva viene modificata in una barra di didascalia inattiva.

In genere, una finestra viene lampeggiata per informare l'utente che la finestra richiede attenzione, ma che attualmente non ha lo stato attivo della tastiera.

La funzione FlashWindow lampeggia la finestra una sola volta; per il flash ripetuto, l'applicazione deve creare un timer di sistema.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll

Vedi anche

Funzioni di gestione degli errori

Notifica all'utente