Partager via


Méthode ITfMouseTrackerACP::AdviseMouseSink (msctf.h)

Appelé pour installer un récepteur d’événements de souris.

Syntaxe

HRESULT AdviseMouseSink(
  [in]  ITfRangeACP  *range,
  [in]  ITfMouseSink *pSink,
  [out] DWORD        *pdwCookie
);

Paramètres

[in] range

Pointeur vers une interface ITfRange qui spécifie la plage de texte pour laquelle le récepteur de souris est installé.

[in] pSink

Pointeur vers l’interface ITfMouseSink . L’application doit incrémenter ce nombre de références d’objets et enregistrer l’interface.

[out] pdwCookie

Pointeur vers un DWORD qui reçoit un cookie qui identifie le récepteur d’événements de souris.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Valeur Description
S_OK
La méthode a réussi.
E_INVALIDARG
Un ou plusieurs paramètres ne sont pas valides.
E_NOTIMPL
L’application ne prend pas en charge les récepteurs d’événements de souris.

Notes

Lorsque ce récepteur d’avertissement est installé, un événement de souris qui se produit sur la plage spécifiée par plage entraîne l’appel de la méthode ITfMouseSink::OnMouseEvent du récepteur d’événements de souris.

La valeur placée dans pdwCookie sera enregistrée par l’appelant et passée à la méthode ITfMouseTrackerACP::UnadviseMouseSink pour supprimer le récepteur d’événements de souris.

Spécifications

   
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 msctf.h
DLL Msctf.dll
Composant redistribuable TSF 1.0 sur Windows 2000 Professionnel

Voir aussi

ITfMouseSink

ITfMousesink::OnMouseEvent

ITfMouseTrackerACP

ITfMouseTrackerACP::UnadviseMouseSink

ITfRange