Dela via


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.

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
Winuser.h (inkludera Windows.h)

Se även

Meddelanden

referens

GET_POINTERID_WPARAM

IS_POINTER_NEW_WPARAM

IS_POINTER_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM