ITfMouseTracker::AdviseMouseSink 方法 (msctf.h)

安装鼠标事件接收器。

语法

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

parameters

[in] range

指向 ITfRange 接口的指针,该接口指定为其安装鼠标接收器的文本范围。

[in] pSink

指向 ITfMouseSink 接口的 指针。

[out] pdwCookie

指向 DWORD 值的指针,该值接收标识鼠标事件接收器的 Cookie。

返回值

此方法可以返回其中一个值。

说明
S_OK
方法成功。
E_INVALIDARG
一个或多个参数无效。
TF_E_DISCONNECTED
上下文对象不在文档堆栈上。
E_NOTIMPL
上下文所有者不支持鼠标事件接收器。
E_FAIL
发生了未指定的错误。

注解

安装建议接收器时,在 范围 指定的范围内发生的鼠标事件将导致鼠标事件接收器 ITfMouseSink::OnMouseEvent 调用。

必须将 放置在 pdwCookie 中的值保存并传递给 ITfMouseTracker::UnadviseMouseSink 才能删除鼠标事件接收器。

要求

   
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 msctf.h
DLL Msctf.dll
可再发行组件 Windows 2000 专业版上的 TSF 1.0

另请参阅

ITfMouseSink

ITfMouseSink::OnMouseEvent

ITfMouseTracker

ITfMouseTracker::UnadviseMouseSink

ITfRange