CWnd::FlashWindow

Articolo
06/10/2015

Infiamma una volta la finestra specificata.

BOOL FlashWindow( 
   BOOL bInvert  
);

Parametri

bInvert
Specifica se CWnd deve essere infiammato o restituito allo stato originale. CWnd è infiammato da uno stato a un altro se bInvert è TRUE. Se bInvert è FALSE, la finestra viene ripristinato lo stato originale (attivo o inattivo).

Valore restituito

Diverso da zero se la finestra è attiva prima della chiamata alla funzione membro FlashWindow ; in caso contrario 0.

Note

Per il lampeggiamento successivo, creare un timer di sistema e chiamare ripetutamente FlashWindow. Infiammando CWnd significa modificarne l'aspetto della barra del titolo come se CWnd stesse modificato da inattivo stato attivo, o viceversa. (Modifiche inattive di una barra del titolo a una didascalia attiva, modifiche attive di una barra del titolo a una didascalia inattiva.)

In genere, una finestra è infiammata per informare l'utente che richiede l'attenzione ma attualmente non ha lo stato attivo per l'input.

Il parametro bInvert deve essere FALSE solo quando la finestra viene visualizzato lo stato di attivazione e non lampeggerà; deve essere TRUE sulle chiamate successive in attesa di ottenere lo stato attivo per l'input.

Questa funzione restituisce sempre diverso da zero per le finestre ridotte a icona. Se la finestra è ridotta a icona, FlashWindow lampeggerà semplicemente l'icona della finestra; bInvert viene ignorato per windows ridotte a icona.

Esempio

BOOL CPenWidthsDlg::OnInitDialog()
{
   CDialog::OnInitDialog();

   // set timer to cause dialog to flash
   SetTimer(1, 500, NULL);
   return TRUE;  // return TRUE unless you set the focus to a control
}

void CPenWidthsDlg::OnTimer(UINT_PTR nIDEvent)
{
   // cause the dialog to flash
   FlashWindow(TRUE);
   CDialog::OnTimer(nIDEvent);
}