Partager via


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

Installe un récepteur d’événements de souris.

Syntaxe

HRESULT AdviseMouseSink(
  [in]  ITfRange     *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 .

[out] pdwCookie

Pointeur vers une valeur 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.
TF_E_DISCONNECTED
L’objet de contexte ne se trouve pas sur une pile de documents.
E_NOTIMPL
Le propriétaire du contexte ne prend pas en charge les récepteurs d’événements de souris.
E_FAIL
Une erreur non spécifiée s'est produite.

Notes

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

La valeur placée dans pdwCookie doit être enregistrée et passée à ITfMouseTracker::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

ITfMouseTracker

ITfMouseTracker::UnadviseMouseSink

ITfRange