WM_POINTERENTER meddelande
Skickas till ett fönster när en ny pekare anger identifieringsintervallet över fönstret (hovring) eller när en befintlig pekare flyttas inom fönstrets gränser.
Ett fönster tar emot det här meddelandet via funktionen WindowProc.
! [Viktigt]
Skrivbordsappar bör vara DPI-medvetna. Om din app inte är DPI-medveten kan skärmkoordinater i pekarmeddelanden och relaterade strukturer verka felaktiga på grund av DPI-virtualisering. DPI-virtualisering ger stöd för automatisk skalning till program som inte är DPI-medvetna och som är aktiva som standard (användarna kan inaktivera den). Mer information finns i Writing High-DPI Win32 Applications.
#define WM_POINTERENTER 0x0249
Parametrar
-
wParam
-
Innehåller pekaridentifieraren och tilläggsinformation. Använd följande makron för att hämta specifik information i parametern wParam.
- GET_POINTERID_WPARAM(wParam): pekaridentifieraren.
- IS_POINTER_NEW_WPARAM(wParam): anger om det här meddelandet är det första meddelandet som genereras av en ny pekare som anger identifieringsintervall (hovring).
- IS_POINTER_INRANGE_WPARAM(wParam): anger om det här meddelandet genererades av en pekare som inte har lämnat identifieringsintervallet. Den här flaggan är alltid inställd för WM_POINTERENTER meddelanden.
- IS_POINTER_INCONTACT_WPARAM(wParam): en flagga som anger om det här meddelandet genererades av en pekare som är i kontakt. Den här flaggan har inte angetts för en pekare i identifieringsintervallet (hovring).
-
lParam
-
Innehåller pekarens punktplats.
Not
Eftersom pekaren kan komma i kontakt med enheten över ett icke-trivialt område kan den här punktplatsen vara en förenkling av ett mer komplext pekarområde. När det är möjligt bör ett program använda fullständig information om pekarområdet i stället för punktplatsen.
Använd följande makron för att hämta punktens fysiska skärmkoordinater.
- GET_X_LPARAM(lParam): koordinaten x (vågrät punkt).
- GET_Y_LPARAM(lParam): koordinaten y (lodrät punkt).
Returvärde
Om ett program bearbetar det här meddelandet ska det returnera noll.
Om programmet inte bearbetar det här meddelandet bör det anropa DefWindowProc.
Anmärkningar
WM_POINTERENTER-meddelandet kan användas av ett fönster för att ge feedback till användaren när pekaren är över dess yta eller för att på annat sätt reagera på förekomsten av en pekare över dess yta.
Det här meddelandet skickas endast till fönstret som tar emot indata för pekaren. I följande tabell visas några av de situationer då det här meddelandet skickas.
| Handling | Uppsättning flaggor | Meddelanden som skickas till |
|---|---|---|
| En ny pekare anger identifieringsintervall (hovring). |
IS_POINTER_NEW_WPARAM IS_POINTER_INRANGE_WPARAM |
Fönster där pekaren anger identifieringsintervallet. |
| En hovringspekare korsar inom fönstergränserna. |
IS_POINTER_INRANGE_WPARAM |
Fönster där pekaren har korsats. |
! [Viktigt]
När ett fönster förlorar avbildningen av en pekare och det tar emot WM_POINTERCAPTURECHANGED-meddelandet, får det vanligtvis inga ytterligare meddelanden. Därför är det viktigt att du inte gör några antaganden baserat på jämnt kopplade WM_POINTERDOWN/WM_POINTERUP eller WM_POINTERENTER/WM_POINTERLEAVE meddelanden.
När indata kommer från musen, till följd av integrering av mus- och pekarmeddelanden, skickas inte WM_POINTERENTER.
Krav
| Krav | Värde |
|---|---|
| Lägsta klient som stöds |
Windows 8 [endast skrivbordsappar] |
| Lägsta server som stöds |
Windows Server 2012 [endast skrivbordsappar] |
| Rubrik |
|