Método ITfMouseTracker::AdviseMouseSink (msctf.h)
Instala um coletor de eventos do mouse.
Sintaxe
HRESULT AdviseMouseSink(
[in] ITfRange *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 .
[out] pdwCookie
Ponteiro para um valor 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 objeto de contexto não está em uma pilha de documentos. |
|
O proprietário do contexto não dá suporte a coletores de eventos do mouse. |
|
Ocorreu um erro não especificado. |
Comentários
Quando o coletor de aviso é instalado, um evento do mouse que ocorre sobre o intervalo especificado por intervalo resultará na chamada ITfMouseSink::OnMouseEvent do coletor de eventos do mouse.
O valor colocado em pdwCookie deve ser salvo e passado para ITfMouseTracker::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 |