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 |