WM_XBUTTONDOWN bericht
Geplaatst wanneer de gebruiker op XBUTTON1 of XBUTTON2 drukt terwijl de cursor zich in het clientgebied van een venster bevindt. Als de muis niet wordt vastgelegd, wordt het bericht onder de cursor in het venster geplaatst. Anders wordt het bericht geplaatst in het venster dat de muis heeft vastgelegd.
Een venster ontvangt dit bericht via de functie WindowProc.
#define WM_XBUTTONDOWN 0x020B
Parameters
-
wParam-
-
Het woord met een lage volgorde geeft aan of verschillende virtuele sleutels niet beschikbaar zijn. Dit kan een of meer van de volgende waarden zijn.
Waarde Betekenis - MK_CONTROL
- 0x0008
De Ctrl-toets is niet beschikbaar. - MK_LBUTTON
- 0x0001
De linkermuisknop is offline. - MK_MBUTTON
- 0x0010
De middelste muisknop is omlaag. - MK_RBUTTON
- 0x0002
De rechtermuisknop is omlaag. - MK_SHIFT
- 0x0004
De Shift-toets is niet beschikbaar. - MK_XBUTTON1
- 0x0020
De XBUTTON1 is offline. - MK_XBUTTON2
- 0x0040
De XBUTTON2 is uit. Het woord met hoge volgorde geeft aan op welke knop is geklikt. Dit kan een van de volgende waarden zijn.
Waarde Betekenis - XBUTTON1
- 0x0001
Er is op de XBUTTON1 geklikt. - XBUTTON2
- 0x0002
Er is op de XBUTTON2 geklikt. -
lParam-
-
Het woord met lage volgorde geeft de x-coördinaat van de cursor aan. De coördinaat is relatief ten opzichte van de linkerbovenhoek van het clientgebied.
Het woord met hoge volgorde geeft de y-coördinaat van de cursor aan. De coördinaat is relatief ten opzichte van de linkerbovenhoek van het clientgebied.
Retourwaarde
Als een toepassing dit bericht verwerkt, moet deze TRUE-retourneren. Zie de sectie Opmerkingen voor meer informatie over het verwerken van de retourwaarde.
Opmerkingen
Windows ondersteunt muizen met maximaal vijf knoppen: links, midden en rechts, plus twee extra knoppen genaamd XBUTTON1 en XBUTTON2. De knoppen XBUTTON1 en XBUTTON2 bevinden zich vaak aan de zijkanten van de muis, in de buurt van de basis. Deze extra knoppen zijn niet aanwezig op alle muizen. Indien aanwezig, worden de knoppen XBUTTON1 en XBUTTON2 vaak toegewezen aan een toepassingsfunctie, zoals vooruit- en achteruitnavigatie in een webbrowser.
Gebruik de volgende code om de informatie op te halen in de parameter wParam:
fwKeys = GET_KEYSTATE_WPARAM (wParam);
fwButton = GET_XBUTTON_WPARAM (wParam);
Gebruik de volgende code om de horizontale en verticale positie te verkrijgen:
xPos = GET_X_LPARAM(lParam);
yPos = GET_Y_LPARAM(lParam);
Zoals hierboven vermeld, bevindt de x-coördinaat zich in de lage volgorde korte van de retourwaarde; de y-coördinaat bevindt zich in de volgorde korte (beide vertegenwoordigen ondertekende waarden omdat ze negatieve waarden op systemen met meerdere monitors kunnen aannemen). Als de retourwaarde is toegewezen aan een variabele, kunt u de macro MAKEPOINTS- gebruiken om een PUNTEN structuur te verkrijgen van de retourwaarde. U kunt ook de GET_X_LPARAM of GET_Y_LPARAM macro gebruiken om de x- of y-coördinaat op te halen.
Belangrijk
Gebruik de LOWORD- of HIWORD- macro's niet om de x- en y-coördinaten van de cursorpositie te extraheren, omdat deze macro's onjuiste resultaten retourneren op systemen met meerdere beeldschermen. Systemen met meerdere monitors kunnen negatieve x- en y-coördinaten hebben, en LOWORD- en HIWORD- de coördinaten behandelen als niet-ondertekende hoeveelheden.
In tegenstelling tot de WM_LBUTTONDOWN, WM_MBUTTONDOWNen WM_RBUTTONDOWN berichten, moet een toepassing TRUE- van dit bericht retourneren als het wordt verwerkt. Hierdoor kan software die dit bericht simuleert op Windows-systemen ouder dan Windows 2000, bepalen of de vensterprocedure het bericht heeft verwerkt of DefWindowProc- om het te verwerken.
Eisen
| Eis | Waarde |
|---|---|
| Minimaal ondersteunde client |
Windows 2000 Professional [alleen desktop-apps] |
| Minimaal ondersteunde server |
Windows 2000 Server [alleen desktop-apps] |
| Rubriek |
|
Zie ook
-
-
conceptuele
-
andere resources