WM_POINTERENTER bericht

Verzonden naar een venster wanneer een nieuwe aanwijzer het detectiebereik over het venster binnenkomt (aanwijzen) of wanneer een bestaande aanwijzer binnen de grenzen van het venster wordt verplaatst.

Een venster ontvangt dit bericht via de functie WindowProc.

! [Belangrijk]
Desktop-apps moeten DPI-bewust zijn. Als uw app geen DPI-kennis heeft, kunnen schermcoördinaten in aanwijzerberichten en gerelateerde structuren onnauwkeurig lijken vanwege DPI-virtualisatie. DPI-virtualisatie biedt ondersteuning voor automatisch schalen voor toepassingen die niet dpi-bewust zijn en die standaard actief zijn (gebruikers kunnen deze uitschakelen). Zie Writing High-DPI Win32 Applicationsvoor meer informatie.

#define WM_POINTERENTER                 0x0249

Parameters

wParam-

Bevat de aanwijzer-id en aanvullende informatie. Gebruik de volgende macro's om specifieke informatie op te halen in de parameter wParam.

• GET_POINTERID_WPARAM(wParam): de aanwijzer-id.
• IS_POINTER_NEW_WPARAM(wParam): geeft aan of dit bericht het eerste bericht is dat wordt gegenereerd door een nieuwe aanwijzer die het detectiebereik invoert (hover).
• IS_POINTER_INRANGE_WPARAM(wParam): geeft aan of dit bericht is gegenereerd door een aanwijzer die geen detectiebereik heeft verlaten. Deze vlag is altijd ingesteld voor WM_POINTERENTER berichten.
• IS_POINTER_INCONTACT_WPARAM(wParam): een vlag die aangeeft of dit bericht is gegenereerd door een aanwijzer die in contact is. Deze vlag is niet ingesteld voor een aanwijzer in het detectiebereik (hover).

lParam-

Bevat de puntlocatie van de aanwijzer.

Notitie

Omdat de aanwijzer contact kan maken met het apparaat via een niet-triviaal gebied, kan deze puntlocatie een vereenvoudiging zijn van een complexer puntgebied. Indien mogelijk moet een toepassing de volledige informatie over het aanwijzergebied gebruiken in plaats van de puntlocatie.

Gebruik de volgende macro's om de fysieke schermcoördinaten van het punt op te halen.

• GET_X_LPARAM(lParam): de coördinaat x (horizontaal punt).
• GET_Y_LPARAM(lParam): de coördinaat y (verticaal punt).

Retourwaarde

Als een toepassing dit bericht verwerkt, moet het nul retourneren.

Als dit bericht niet door de toepassing wordt verwerkt, moet deze DefWindowProc-aanroepen.

Opmerkingen

De WM_POINTERENTER melding kan worden gebruikt door een venster om feedback te geven aan de gebruiker terwijl de aanwijzer boven het oppervlak staat of om op een andere manier te reageren op de aanwezigheid van een aanwijzer op het oppervlak.

Deze melding wordt alleen verzonden naar het venster dat invoer voor de aanwijzer ontvangt. De volgende tabel bevat enkele situaties waarin deze melding wordt verzonden.

! [Belangrijk]
Wanneer een venster de opname van een aanwijzer verliest en de melding WM_POINTERCAPTURECHANGED ontvangt, ontvangt het meestal geen verdere meldingen. Daarom is het belangrijk dat u geen veronderstellingen maakt op basis van gelijkmatig gekoppelde WM_POINTERDOWN/WM_POINTERUP of WM_POINTERENTER/WM_POINTERLEAVE meldingen.

Wanneer invoer afkomstig is van de muis, als gevolg van de integratie van muis- en aanwijzerberichten, wordt WM_POINTERENTER niet verzonden.

Eisen

Zie ook

berichten

GET_POINTERID_WPARAM

IS_POINTER_NEW_WPARAM

IS_POINTER_INRANGE_WPARAM

IS_POINTER_INCONTACT_WPARAM