WM_NCACTIVATE message

  • Article

Envoyé à une fenêtre lorsque sa zone non cliente doit être modifiée pour indiquer un état actif ou inactif.

Une fenêtre reçoit ce message via sa fonction WindowProc.

#define WM_NCACTIVATE                   0x0086

Paramètres

wParam

Indique quand une barre de titre ou une icône doit être modifiée pour indiquer un état actif ou inactif. Si une barre de titre ou une icône active doit être dessinée, le paramètre wParam est TRUE. Si une barre de titre inactive ou une icône doit être dessinée, wParam a la valeur FALSE.

lParam

Lorsqu’un style visuel est actif pour cette fenêtre, ce paramètre n’est pas utilisé.

Lorsqu’un style visuel n’est pas actif pour cette fenêtre, ce paramètre est un handle vers une région de mise à jour facultative pour la zone non cliente de la fenêtre. Si ce paramètre a la valeur -1, DefWindowProc ne repeint pas la zone non cliente pour refléter le changement d’état.

Valeur retournée

Type : LRESULT

Lorsque le paramètre wParam a la valeur FALSE, une application doit retourner TRUE pour indiquer que le système doit poursuivre le traitement par défaut, ou qu’elle doit retourner FALSE pour empêcher la modification. Lorsque wParam a la valeur TRUE, la valeur de retour est ignorée.

Remarques

Le traitement des messages liés à la zone non client d’une fenêtre standard n’est pas recommandé, car l’application doit être en mesure de dessiner toutes les parties requises de la zone non cliente pour la fenêtre. Si une application traite ce message, elle doit retourner TRUE pour diriger le système vers la fin de la modification de la fenêtre active. Si la fenêtre est réduite lorsque ce message est reçu, l’application doit passer le message à la fonction DefWindowProc .

La fonction DefWindowProc dessine la barre de titre ou le titre de l’icône dans ses couleurs actives lorsque le paramètre wParam a la valeur TRUE et dans ses couleurs inactives lorsque wParam a la valeur FALSE.

Configuration requise

Condition requise Valeur
Client minimal pris en charge
 Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge
 Windows 2000 Server [applications de bureau uniquement]
En-tête
Winuser.h (include Windows.h)

Voir aussi

Référence

DefWindowProc

Conceptuel

Windows