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

Récupère la stratégie d’activation actuelle pour l’objet . Cette méthode est appelée par le conteneur à la réception d’un message WM_SETCURSOR ou WM_MOUSEMOVE lorsqu’un objet inactif se trouve sous le pointeur de la souris.

Syntaxe

HRESULT GetActivationPolicy(
  [out] DWORD *pdwPolicy
);

Paramètres

[out] pdwPolicy

Pointeur vers une variable qui reçoit la stratégie d’activation. Les valeurs possibles proviennent de l’énumération POINTERINACTIVE .

Valeur retournée

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

Remarques

L’objet peut demander à être activé sur place dès que la souris l’entre par le biais de la valeur POINTERINACTIVE_ACTIVATEONENTRY. Un objet qui fournit plus de commentaires visuels que la simple définition du pointeur de la souris utiliserait cette valeur. Par exemple, si l’objet prend en charge un retour visuel spécial, il doit entrer dans l’état actif pour pouvoir dessiner le retour visuel qu’il prend en charge.

Un objet peut également utiliser cette méthode pour demander l’activation lorsque la souris est déplacée sur lui au cours d’une opération de glisser-déplacer dans le POINTERINACTIVE_ACTIVATEONDRAG.

Si l’objet retourne l’une de ces valeurs, le conteneur doit activer immédiatement l’objet et transférer le message Window qui a déclenché l’appel. L’objet reste ensuite actif et traite les messages suivants via sa propre fenêtre jusqu’à ce que le conteneur obtienne une autre WM_SETCURSOR ou WM_MOUSEMOVE. À ce stade, le conteneur doit désactiver l’objet .

Pour les objets OLE sans fenêtre, ce mécanisme est légèrement différent. Pour plus d’informations sur les opérations de glisser-déplacer pour les objets sans fenêtre, consultez IOleInPlaceSiteWindowless .

Si l’objet retourne les valeurs POINTERINACTIVE_ACTIVATEONENTRY et POINTERINACTIVE_DEACTIVATEONLEAVE, l’objet est activé uniquement lorsque la souris est au-dessus de l’objet. Si la valeur POINTERINACTIVE_ACTIVATEONENTRY seule est définie, l’objet est activé une fois lorsque la souris l’entre pour la première fois, et il reste actif.

Remarques aux appelants

La stratégie d’activation ne doit pas être mise en cache. Le conteneur doit appeler cette méthode chaque fois que la souris entre dans un objet inactif.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	ocidl.h

Voir aussi

IOleInPlaceSiteWindowless

IPointerInactive