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

Artículo
08/24/2023

Instala un receptor de eventos del mouse.

Sintaxis

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

Parámetros

[in] range

Puntero a una interfaz ITfRange que especifica el intervalo de texto para el que está instalado el receptor del mouse.

[in] pSink

Puntero a la interfaz ITfMouseSink .

[out] pdwCookie

Puntero a un valor DWORD que recibe una cookie que identifica el receptor de eventos del mouse.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor	Descripción
S_OK	Método realizado correctamente.
E_INVALIDARG	Uno o varios parámetros no son válidos.
TF_E_DISCONNECTED	El objeto de contexto no está en una pila de documentos.
E_NOTIMPL	El propietario del contexto no admite receptores de eventos del mouse.
E_FAIL	Se ha producido un error no especificado.

Comentarios

Cuando se instala el receptor de aviso, un evento del mouse que se produce sobre el intervalo especificado por intervalo dará como resultado la llamada ITfMouseSink::OnMouseEvent del receptor de eventos del mouse.

El valor colocado en pdwCookie debe guardarse y pasarse a ITfMouseTracker::UnadviseMouseSink para quitar el receptor de eventos del mouse.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msctf.h
Archivo DLL	Msctf.dll
Redistribuible	TSF 1.0 en Windows 2000 Professional