Freigeben über


WM_NCXBUTTONDBLCLK-Meldung

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

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

#define WM_NCXBUTTONDBLCLK              0x00AD

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 doppelt geklickt wurde. Dieses Argument einen der folgenden Werte annehmen.

Wert Bedeutung
XBUTTON1
0x0001
Auf die erste X-Schaltfläche wurde doppelt geklickt.
XBUTTON2
0x0002
Auf die zweite X-Schaltfläche wurde doppelt 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-Meldung an das Fenster gesendet.

Ein Fenster muss nicht über das CS_DBLCLKS-Format verfügen, um WM_NCXBUTTONDBLCLK-Meldungen zu empfangen. Das System generiert eine WM_NCXBUTTONDBLCLK-Meldung, wenn Benutzer*innen eine X-Schaltfläche innerhalb des Systemzeitlimits für Doppelklicks drücken, loslassen und erneut drücken. Durch Doppelklicken auf eine dieser Schaltflächen werden sogar vier Meldungen generiert: WM_NCXBUTTONDOWN, WM_NCXBUTTONUP, WM_NCXBUTTONDBLCLK und noch einmal WM_NCXBUTTONUP.

Im Gegensatz zu WM_NCLBUTTONDBLCLK-, WM_NCMBUTTONDBLCLK- und WM_NCRBUTTONDBLCLK-Meldungen sollte eine Anwendung aus dieser Meldung 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_NCXBUTTONDOWN

WM_NCXBUTTONUP

WM_SYSCOMMAND

Konzept

Mauseingabe

Weitere Ressourcen

MAKEPOINTS

POINTS