FlashWindow, fonction (winuser.h)

Clignote la fenêtre spécifiée une fois. Elle ne modifie pas l’état actif de la fenêtre.

Pour flasher la fenêtre un nombre spécifié de fois, utilisez la fonction FlashWindowEx .

Syntaxe

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

Paramètres

[in] hWnd

Poignée de la fenêtre à flasher. La fenêtre peut être ouverte ou réduite.

[in] bInvert

Si ce paramètre a la valeur TRUE, la fenêtre est flashée d’un état à l’autre. Si elle a la valeur FALSE, la fenêtre est retournée à son état d’origine (actif ou inactif).

Lorsqu’une application est réduite et que ce paramètre a la valeur TRUE, le bouton de la fenêtre de la barre des tâches clignote actif/inactif. S’il a la valeur FALSE, le bouton de la fenêtre de la barre des tâches clignote inactif, ce qui signifie qu’il ne change pas les couleurs. Il clignote, comme s’il était redessiné, mais il ne fournit pas l’indice visuel inversé à l’utilisateur.

Valeur retournée

La valeur de retour spécifie l’état de la fenêtre avant l’appel à la fonction FlashWindow . Si la fenêtre légende a été dessinée comme étant active avant l’appel, la valeur de retour est différente de zéro. Sinon, la valeur de retour est égale à zéro.

Remarques

Clignoter une fenêtre signifie modifier l’apparence de sa barre de légende comme si la fenêtre passait d’une status inactive à une status active, ou vice versa. (Une barre de légende inactive devient une barre de légende active ; une barre de légende active devient une barre de légende inactive.)

En règle générale, une fenêtre est flashée pour informer l’utilisateur que la fenêtre nécessite une attention, mais qu’elle n’a pas actuellement le focus clavier.

La fonction FlashWindow flashe la fenêtre une seule fois ; pour un clignotement répété, l’application doit créer un minuteur système.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll

Voir aussi

Fonctions de gestion des erreurs

Notification de l’utilisateur