WM_NCXBUTTONDOWN-Nachricht

Wird gesendet, wenn der Benutzer auf die erste oder zweite X-Schaltfläche klickt, während sich der Cursor im Clientbereich eines Fensters befindet. Diese Nachricht wird an das Fenster mit dem Cursor gesendet. Wenn die Maus von einem Fenster erfasst wurde, wird diese Nachricht nicht gesendet.

Ein Fenster empfängt diese Meldung über die WindowProc-Funktion.

#define WM_NCXBUTTONDOWN                0x00AB

Parameter

wParam

Das niederwertige Wort gibt den Treffertestwert an, der von der DefWindowProc-Funktion aus der Verarbeitung der WM_NCHITTEST-Nachricht zurückgegeben wird. Eine Liste der Treffertestwerte finden Sie unter WM_NCHITTEST. Das höherwertige Wort gibt an, auf welche Schaltfläche geklickt wurde. Dieses Argument einen der folgenden Werte annehmen.

Wert Bedeutung
XBUTTON1
0x0001
Auf die erste X-Schaltfläche wurde geklickt.
XBUTTON2
0x0002
Auf die zweite X-Schaltfläche wurde geklickt.

lParam

Ein Zeiger auf eine POINTS-Struktur, die die x- und x-Koordinaten des Cursors enthält. Die Koordinaten sind relativ zur linken oberen Ecke des Bildschirms.

Rückgabewert

Wenn eine Anwendung diese Meldung verarbeitet, sollte TRUE zurückgegeben werden. Weitere Informationen zur Verarbeitung des Rückgabewerts finden Sie im Abschnitt „Bemerkungen“.

Hinweise

Rufen Sie mit dem folgenden Code die Informationen im wParam-Parameter ab.

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

Sie können auch mit dem folgenden Code die X- und Y-Koordinaten von lParam abrufen:

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

Wichtig

Verwenden Sie nicht die LOWORD- oder HIWORD-Makros, um die X- und Y-Koordinaten der Cursorposition zu extrahieren. Diese Makros geben auf Systemen mit mehreren Monitoren falsche Ergebnisse zurück. Systeme mit mehreren Monitoren können negative x- und y-Koordinaten aufweisen, und LOWORD und HIWORD behandeln die Koordinaten als Mengen ohne Vorzeichen.

Standardmäßig testet die DefWindowProc-Funktion den angegebenen Punkt, um die Cursorposition abzurufen, und führt die entsprechende Aktion aus. Falls erforderlich, wird die WM_SYSCOMMAND-Nachricht an das Fenster gesendet.

Im Gegensatz zu den Nachrichten WM_NCLBUTTONDOWN, WM_NCMBUTTONDOWN und WM_NCRBUTTONDOWN muss eine Anwendung für diese Nachricht TRUE zurückgeben, wenn sie diese verarbeitet. Dadurch kann Software, die diese Nachricht auf Windows-Systemen vor Windows 2000 simuliert, bestimmen, ob die Fensterprozedur die Nachricht verarbeitet oder DefWindowProc für die Verarbeitung aufgerufen hat.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows 2000 Server [nur Desktop-Apps]
Header
Winuser.h (einschließlich Windowsx.h)

Siehe auch

Referenz

DefWindowProc

GET_X_LPARAM

GET_Y_LPARAM

WM_NCHITTEST

WM_NCXBUTTONDBLCLK

WM_NCXBUTTONUP

WM_SYSCOMMAND

Konzept

Mauseingabe

Weitere Ressourcen

MAKEPOINTS

POINTS