Share via


Função FlashWindow (winuser.h)

Pisca a janela especificada uma vez. Ele não altera o estado ativo da janela.

Para piscar a janela um número especificado de vezes, use a função FlashWindowEx .

Sintaxe

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

Parâmetros

[in] hWnd

Um identificador para a janela a ser exibida. A janela pode ser aberta ou minimizada.

[in] bInvert

Se esse parâmetro for TRUE, a janela será exibida de um estado para outro. Se for FALSE, a janela será retornada ao estado original (ativo ou inativo).

Quando um aplicativo é minimizado e esse parâmetro é TRUE, o botão da janela da barra de tarefas pisca ativo/inativo. Se for FALSE, o botão da janela da barra de tarefas piscará inativo, o que significa que ele não altera as cores. Ele pisca, como se estivesse sendo redesenhado, mas não fornece a pista de inverter visual para o usuário.

Retornar valor

O valor retornado especifica o estado da janela antes da chamada para a função FlashWindow . Se a legenda da janela foi desenhada como ativa antes da chamada, o valor retornado não será diferente de zero. Caso contrário, o valor retornado será zero.

Comentários

Piscar uma janela significa alterar a aparência de sua barra de legenda como se a janela estivesse mudando de inativa para ativa status ou vice-versa. (Uma barra de legenda inativa é alterada para uma barra de legenda ativa; uma barra de legenda ativa é alterada para uma barra de legenda inativa.)

Normalmente, uma janela é exibida para informar ao usuário que a janela requer atenção, mas que atualmente não tem o foco do teclado.

A função FlashWindow pisca a janela apenas uma vez; para flash repetido, o aplicativo deve criar um temporizador do sistema.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winuser.h (inclua Windows.h)
Biblioteca User32.lib
DLL User32.dll

Confira também

Funções do tratamento de erros

Notificar o usuário