Condividi tramite


Metodo ITfMouseTracker::AdviseMouseSink (msctf.h)

Installa un sink di eventi del mouse.

Sintassi

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

Parametri

[in] range

Puntatore a un'interfaccia ITfRange che specifica l'intervallo di testo per cui è installato il sink del mouse.

[in] pSink

Puntatore all'interfaccia ITfMouseSink .

[out] pdwCookie

Puntatore a un valore DWORD che riceve un cookie che identifica il sink dell'evento del mouse.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore Descrizione
S_OK
Il metodo è stato eseguito correttamente.
E_INVALIDARG
Uno o più parametri non sono validi.
TF_E_DISCONNECTED
L'oggetto di contesto non si trova in uno stack di documenti.
E_NOTIMPL
Il proprietario del contesto non supporta sink di eventi del mouse.
E_FAIL
Si è verificato un errore non specificato.

Commenti

Quando viene installato il sink di avviso, un evento del mouse che si verifica sull'intervallo specificato dall'intervallo determinerà la chiamata ITfMouseSink::OnMouseEvent del sink dell'evento del mouse.

Il valore inserito in pdwCookie deve essere salvato e passato a ITfMouseTracker::UnadviseMouseSink per rimuovere il sink di eventi del mouse.

Requisiti

   
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione msctf.h
DLL Msctf.dll
Componente ridistribuibile TSF 1.0 in Windows 2000 Professional

Vedi anche

ITfMouseSink

ITfMouseSink::OnMouseEvent

ITfMouseTracker

ITfMouseTracker::UnadviseMouseSink

ITfRange