Dela via


WM_POINTERLEAVE meddelande

Skickas till ett fönster när en pekare lämnar identifieringsintervallet över fönstret (hovra) eller när en pekare flyttas utanför 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_POINTERLEAVE                 0x024A

Parametrar

wParam

Innehåller pekaridentifieraren och ytterligare information. Använd följande makron för att hämta den här informationen.

  • GET_POINTERID_WPARAM(wParam): pekaridentifieraren.
  • 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 anges inte när pekaren lämnar fönstrets identifieringsområde.
  • 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

Meddelandet WM_POINTERLEAVE kan användas av ett fönster för att ändra läge eller stoppa feedback till användaren medan pekaren är över fönsterytan.

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 hovringspekare korsar fönstergränserna. IS_POINTER_INRANGE_WPARAM Fönster utanför vars gräns pekaren flyttades.
En pekare hamnar utom detekteringsintervallet. Ej tillämpligt Fönster där pekaren lämnar identifieringsintervallet.

! [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.

Om kontakten underhålls med indatas digitaliseraren och pekaren flyttas utanför fönstret genereras inte WM_POINTERLEAVE. WM_POINTERLEAVE genereras endast när en hovringspekare korsar fönstergränser eller kontakt avslutas.

WM_POINTERLEAVE publiceras i den publicerade meddelandekön om indata kommer från en musenhet.

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_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM