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 |
|
Siehe auch
-
Referenz
-
Konzept
-
Weitere Ressourcen