WM_XBUTTONDOWN Nachricht
Veröffentlicht, wenn der Benutzer die erste oder zweite X-Schaltfläche drückt, während sich der Cursor im Clientbereich eines Fensters befindet. Wenn die Maus nicht erfasst wird, wird die Nachricht an das Fenster unterhalb des Cursors gepostet. Andernfalls wird die Nachricht in das Fenster gepostet, das die Maus erfasst hat.
Ein Fenster empfängt diese Nachricht über seine WindowProc-Funktion .
#define WM_XBUTTONDOWN 0x020B
Parameter
-
wParam
-
Das Wort mit niedriger Reihenfolge gibt an, ob verschiedene virtuelle Tasten unten sind. Es kann sich um einen oder mehrere der folgenden Werte handeln.
Wert Bedeutung - MK_CONTROL
- 0x0008
Die STRG-TASTE ist nach unten. - MK_LBUTTON
- 0x0001
Die linke Maustaste ist nach unten. - MK_MBUTTON
- 0x0010
Die mittlere Maustaste ist unten. - MK_RBUTTON
- 0x0002
Die rechte Maustaste ist nach unten. - MK_SHIFT
- 0x0004
Die UMSCHALTTASTE ist nach unten. - MK_XBUTTON1
- 0x0020
Die erste X-Schaltfläche ist nach unten. - MK_XBUTTON2
- 0x0040
Die zweite X-Schaltfläche ist nach unten. Das Wort mit hoher Reihenfolge 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
-
Das Wort mit niedriger Reihenfolge gibt die x-Koordinate des Cursors an. Die Koordinate ist relativ zur oberen linken Ecke des Clientbereichs.
Das Wort mit hoher Reihenfolge gibt die y-Koordinate des Cursors an. Die Koordinate ist relativ zur oberen linken Ecke des Clientbereichs.
Rückgabewert
Wenn eine Anwendung diese Nachricht verarbeitet, sollte sie TRUE zurückgeben. Weitere Informationen zur Verarbeitung des Rückgabewerts finden Sie im Abschnitt "Hinweise".
Hinweise
Verwenden Sie den folgenden Code, um die Informationen im wParam-Parameter abzurufen:
fwKeys = GET_KEYSTATE_WPARAM (wParam);
fwButton = GET_XBUTTON_WPARAM (wParam);
Verwenden Sie den folgenden Code, um die horizontale und vertikale Position abzurufen:
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
Wie oben erwähnt, befindet sich die x-Koordinate in der geringen Reihenfolge des Rückgabewerts; Die y-Koordinate befindet sich in der kurzen Hochreihenfolge (beide stellen signierte Werte dar, da sie negative Werte für Systeme mit mehreren Monitoren übernehmen können). Wenn der Rückgabewert einer Variablen zugewiesen ist, können Sie das MAKEPOINTS-Makro verwenden, um eine POINTS-Struktur aus dem Rückgabewert abzurufen. Sie können auch das GET_X_LPARAM - oder GET_Y_LPARAM-Makro verwenden, um die x- oder y-Koordinate zu extrahieren.
Wichtig
Verwenden Sie nicht die LOWORD - oder HIWORD-Makros , um die x- und y-Koordinaten der Cursorposition zu extrahieren, da diese Makros falsche Ergebnisse auf Systemen mit mehreren Monitoren zurückgeben. Systeme mit mehreren Monitoren können negative x- und y-Koordinaten aufweisen, und LOWORD und HIWORD behandeln die Koordinaten als nicht signierte Mengen.
Im Gegensatz zu den WM_LBUTTONDOWN, WM_MBUTTONDOWN und WM_RBUTTONDOWN Nachrichten sollte eine Anwendung TRUE von dieser Nachricht zurückgeben, wenn sie verarbeitet wird. Dies ermöglicht software, die diese Nachricht auf Windows Systemen vor Windows 2000 simuliert, um zu bestimmen, ob die Fensterprozedur die Nachricht verarbeitet oder defWindowProc zum Verarbeiten 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
-
Andere Ressourcen