WM_XBUTTONDBLCLK Nachricht
Veröffentlicht, wenn der Benutzer entweder XBUTTON1 oder XBUTTON2 klickt, während sich der Cursor im Clientbereich eines Fensters befindet. Wenn die Maus nicht erfasst wird, wird die Nachricht im Fenster unterhalb des Cursors gepostet. Andernfalls wird die Nachricht in das Fenster gepostet, in dem die Maus erfasst wurde.
Ein Fenster empfängt diese Nachricht über die WindowProc--Funktion.
#define WM_XBUTTONDBLCLK 0x020D
Parameter
-
wParam-
-
Das Wort mit niedriger Reihenfolge gibt an, ob verschiedene virtuelle Schlüssel nach unten angeordnet sind. Dabei kann es 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 unten. - MK_MBUTTON
- 0x0010
Die mittlere Maustaste ist unten. - MK_RBUTTON
- 0x0002
Die rechte Maustaste ist unten. - MK_SHIFT
- 0x0004
Die UMSCHALTTASTE ist nach unten. - MK_XBUTTON1
- 0x0020
Die XBUTTON1 ist unten. - MK_XBUTTON2
- 0x0040
Die XBUTTON2 ist unten. Das Wort "Hochreihenfolge" gibt an, auf welche Schaltfläche doppelt geklickt wurde. Dabei kann es sich um einen der folgenden Werte handeln.
Wert Bedeutung - XBUTTON1
- 0x0001
Die XBUTTON1 wurde doppelt geklickt. - XBUTTON2
- 0x0002
Die XBUTTON2 wurde durch Doppelklicken 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 Meldung verarbeitet, sollte sie TRUE-zurückgeben. Weitere Informationen zur Verarbeitung des Rückgabewerts finden Sie im Abschnitt "Hinweise".
Bemerkungen
Windows unterstützt Mäuse mit bis zu fünf Tasten: links, mittel und rechts sowie zwei zusätzliche Schaltflächen, die XBUTTON1 und XBUTTON2 genannt werden. Die schaltflächen XBUTTON1 und XBUTTON2 befinden sich häufig an den Seiten der Maus, nahe der Basis. Diese zusätzlichen Tasten sind nicht auf allen Mäusen vorhanden. Wenn vorhanden, werden die Schaltflächen XBUTTON1 und XBUTTON2 häufig einer Anwendungsfunktion zugeordnet, z. B. der Vorwärts- und Rückwärtsnavigation in einem Webbrowser.
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 niedrigen Reihenfolge kurzen des Rückgabewerts; Die Y-Koordinate befindet sich in der hohen Reihenfolge kurzen (beide stellen signierten Werte dar, da sie negative Werte auf Systemen mit mehreren Monitoren annehmen 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- die Koordinaten als nicht signierte Mengen behandeln.
Nur Fenster mit CS_DBLCLKS Formatvorlage können WM_XBUTTONDBLCLK Nachrichten empfangen, die das System generiert, wenn der Benutzer drückt, loslässt und erneut entweder XBUTTON1 oder XBUTTON2 innerhalb des Doppelklick-Zeitlimits des Systems drückt. Durch Doppelklicken auf eine dieser Schaltflächen werden tatsächlich vier Nachrichten generiert: WM_XBUTTONDOWN, WM_XBUTTONUP, WM_XBUTTONDBLCLKund erneut WM_XBUTTONUP.
Im Gegensatz zu den nachrichten WM_LBUTTONDBLCLK, WM_MBUTTONDBLCLKund WM_RBUTTONDBLCLK sollte eine Anwendung TRUE- von dieser Nachricht zurückgeben, wenn sie verarbeitet wird. Auf diese Weise können Software, die diese Meldung auf Windows-Systemen vor Windows 2000 simuliert, ermöglichen, zu bestimmen, ob die Fensterprozedur die Nachricht verarbeitet oder DefWindowProc- verarbeitet hat.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client |
Windows 2000 Professional [nur Desktop-Apps] |
| Mindestens unterstützter Server |
Windows 2000 Server [nur Desktop-Apps] |
| Kopfball |
|
Siehe auch
-
Referenz-
-
Konzeptionelle
-
andere Ressourcen