Método ITfMouseTrackerACP::AdviseMouseSink (msctf.h)
Chamado para instalar um coletor de eventos do mouse.
Sintaxe
HRESULT AdviseMouseSink(
[in] ITfRangeACP *range,
[in] ITfMouseSink *pSink,
[out] DWORD *pdwCookie
);
Parâmetros
[in] range
Ponteiro para uma interface ITfRange que especifica o intervalo de texto para o qual o coletor do mouse está instalado.
[in] pSink
Ponteiro para a interface ITfMouseSink . O aplicativo deve incrementar essa contagem de referência de objeto e salvar a interface.
[out] pdwCookie
Ponteiro para um DWORD que recebe um cookie que identifica o coletor de eventos do mouse.
Valor retornado
Esse método pode retornar um desses valores.
| Valor | Descrição |
|---|---|
|
O método foi bem-sucedido. |
|
Um ou mais parâmetros são inválidos. |
|
O aplicativo não dá suporte a coletores de eventos do mouse. |
Comentários
Quando esse coletor de aviso é instalado, um evento do mouse que ocorre sobre o intervalo especificado por intervalo resultará na chamada do método ITfMouseSink::OnMouseEvent do coletor de eventos do mouse.
O valor colocado no pdwCookie será salvo pelo chamador e passado para o método ITfMouseTrackerACP::UnadviseMouseSink para remover o coletor de eventos do mouse.
Requisitos
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | msctf.h |
| DLL | Msctf.dll |
| Redistribuível | TSF 1.0 no Windows 2000 Professional |