Freigeben über


ITfMouseTracker::AdviseMouseSink-Methode (msctf.h)

Installiert eine Mausereignissenke.

Syntax

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

Parameter

[in] range

Zeiger auf eine ITfRange-Schnittstelle , die den Textbereich angibt, für den die Maussenke installiert ist.

[in] pSink

Zeiger auf die ITfMouseSink-Schnittstelle .

[out] pdwCookie

Zeiger auf einen DWORD-Wert, der ein Cookie empfängt, das die Mausereignissenke identifiziert.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Wert BESCHREIBUNG
S_OK
Die Methode war erfolgreich.
E_INVALIDARG
Mindestens ein Parameter ist ungültig.
TF_E_DISCONNECTED
Das Kontextobjekt befindet sich nicht in einem Dokumentstapel.
E_NOTIMPL
Der Kontextbesitzer unterstützt keine Mausereignissenken.
E_FAIL
Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Wenn die Empfehlungssenke installiert ist, führt ein Mausereignis, das über den durch bereich angegebenen Bereich hinaus auftritt, zum ITfMouseSink::OnMouseEvent-Aufruf der Mausereignissenke.

Der in pdwCookie platzierte Wert muss gespeichert und an ITfMouseTracker::UnadviseMouseSink übergeben werden, um die Mausereignissenke zu entfernen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile msctf.h
DLL Msctf.dll
Verteilbare Komponente TSF 1.0 unter Windows 2000 Professional

Weitere Informationen

ITfMouseSink

ITfMouseSink::OnMouseEvent

ITfMouseTracker

ITfMouseTracker::UnadviseMouseSink

ITfRange