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

Voir aussi

Fonctions de gestion des erreurs

Notification de l’utilisateur