Méthode IPointerInactive ::OnInactiveMouseMove (ocidl.h)

Avertit l’objet que le pointeur de la souris s’est déplacé sur lui afin que l’objet puisse déclencher des événements de souris. Cette méthode est appelée par le conteneur à la réception d’une méthode WM_MOUSEMOVE lorsqu’un objet inactif se trouve sous le pointeur de la souris.

Syntaxe

HRESULT OnInactiveMouseMove(
  [in] LPCRECT pRectBounds,
  [in] LONG    x,
  [in] LONG    y,
  [in] DWORD   grfKeyState
);

Paramètres

[in] pRectBounds

Rectangle englobant de l’objet, en coordonnées client de la fenêtre conteneur. Ce paramètre indique à l’objet sa position et sa taille exactes à l’écran lorsque le message WM_MOUSEMOVE a été reçu. Cette valeur est spécifiée en unités du système de coordonnées du client.

[in] x

Coordonnée horizontale de l’emplacement de la souris en unités de la fenêtre conteneur du client.

[in] y

Coordonnée verticale de l’emplacement de la souris en unités de la fenêtre contenant du client.

[in] grfKeyState

État actuel des touches de modification du clavier. Les valeurs possibles peuvent être une combinaison des valeurs MK_CONTROL, MK_SHIFT, MK_ALT, MK_BUTTON, MK_LBUTTON, MK_MBUTTON et MK_RBUTTON.

Valeur retournée

Si la méthode réussit, la valeur de retour est S_OK. Sinon, c’est E_FAIL.

Remarques

Le conteneur appelle cette méthode pour informer l’objet que le pointeur de la souris se trouve sur l’objet après avoir vérifié la stratégie d’activation de l’objet en appelant la méthode IPointerInactive ::GetActivationPolicy . Si l’objet n’a pas demandé à être activé sur place via cet appel, le conteneur distribue les messages WM_MOUSEMOVE suivants à l’objet inactif en appelant OnInactiveMouseMove tant que le pointeur de la souris reste sur l’objet. L’objet peut ensuite déclencher des événements de déplacement de souris.

Pour éviter les erreurs d’arrondi et faciliter le travail sur l’implémenteur d’objets, cette méthode prend les coordonnées de fenêtre dans les unités de sa fenêtre cliente contenante, c’est-à-dire la fenêtre dans laquelle l’objet est affiché, au lieu des unités HIMETRIC habituelles . Ainsi, les mêmes coordonnées et le même chemin de code peuvent être utilisés lorsque l’objet est actif et inactif. Les coordonnées de la fenêtre spécifient la position de la souris. Le rectangle englobant est également spécifié dans le même système de coordonnées.

Configuration requise

Voir aussi

IPointerInactive