Message WM_NCXBUTTONDBLCLK

Publié lorsque l'utilisateur double-clique sur le premier ou le second bouton X lorsque le curseur se situe dans la zone non cliente d'une fenêtre. Ce message est publié dans la fenêtre qui contient le curseur. Si une fenêtre a capturé la souris, ce message n’est pas publié.

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

#define WM_NCXBUTTONDBLCLK              0x00AD

Paramètres

wParam

Le mot d’ordre réduit indique la valeur de test d’accès retournée par la fonction DefWindowProc lors du traitement du message WM_NCHITTEST. Pour obtenir la liste des valeurs de test d’accès, consultez WM_NCHITTEST.

Le mot de poids fort indique sur quel bouton un double-clic a été effectué. Il peut avoir l’une des valeurs suivantes.

Valeur Signification
XBUTTON1
0x0001
Double-clic sur le premier bouton X.
XBUTTON2
0x0002
Double-clic sur le deuxième bouton X.

lParam

Un pointeur sur une structure POINTS qui contient les coordonnées x et y du curseur. Les coordonnées sont relatives au coin supérieur gauche de l’écran.

Valeur retournée

Si une application traite ce message, elle doit retourner TRUE. Pour plus d’informations sur le traitement de la valeur de retour, consultez la section Remarques.

Notes

Utilisez le code suivant pour obtenir les informations dans le paramètre wParam.

nHittest = GET_NCHITTEST_WPARAM(wParam); 
fwButton = GET_XBUTTON_WPARAM(wParam); 

Vous pouvez également utiliser le code suivant pour obtenir les coordonnées x et y de lParam :

xPos = GET_X_LPARAM(lParam); 
yPos = GET_Y_LPARAM(lParam); 

Important

N’utilisez pas les macros LOWORD ou HIWORD pour extraire les coordonnées x et y de la position du curseur, car ces macros retournent des résultats incorrects sur les systèmes avec plusieurs moniteurs. Les systèmes avec plusieurs moniteurs peuvent avoir des coordonnées x et y négatives, et LOWORD et HIWORD traitent les coordonnées comme des quantités non signées.

Par défaut, la fonction DefWindowProc teste le point spécifié pour obtenir la position du curseur et effectue l’action appropriée. Le cas échéant, elle envoie le message WM_SYSCOMMAND à la fenêtre.

Une fenêtre n’a pas besoin d’avoir le style CS_DBLCLKS pour recevoir les messages WM_NCXBUTTONDBLCLK. Le système génère un message WM_NCXBUTTONDBLCLK lorsque l’utilisateur appuie, relâche et appuie à nouveau sur un bouton X dans la limite de double-clic du système. Le double-clic sur l’un de ces boutons génère en fait quatre messages : WM_NCXBUTTONDOWN, WM_NCXBUTTONUP, WM_NCXBUTTONDBLCLK et de nouveau WM_NCXBUTTONUP.

Contrairement aux messages WM_NCLBUTTONDBLCLK, WM_NCMBUTTONDBLCLK et WM_NCRBUTTONDBLCLK, une application doit retourner TRUE à partir de ce message si elle le traite. Cela permet aux logiciels qui simulent ce message sur les systèmes Windows antérieurs à Windows 2000 de déterminer si la procédure de fenêtrage a traité le message ou appelé DefWindowProc pour le traiter.

Spécifications

Condition requise Value
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 (y compris Windowsx.h)

Voir aussi

Référence

DefWindowProc

GET_X_LPARAM

GET_Y_LPARAM

WM_NCHITTEST

WM_NCXBUTTONDOWN

WM_NCXBUTTONUP

WM_SYSCOMMAND

Conceptuel

Entrées de la souris

Autres ressources

MAKEPOINTS

POINTS