ITfMouseTrackerACP::AdviseMouseSink メソッド (msctf.h)

マウスイベントシンクをインストールするために呼び出されます。

構文

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

[in] range

マウスシンクがインストールされているテキストの範囲を指定する ITfRange インターフェイスへのポインター。

[in] pSink

ITfMouseSink インターフェイスへのポインター。アプリケーションでは、このオブジェクト参照数をインクリメントし、インターフェイスを保存する必要があります。

[out] pdwCookie

マウスイベントシンクを識別する Cookie を受け取る DWORD へのポインター。

このメソッドは、これらの値のいずれかを返すことができます。

値	説明
S_OK	メソッドは正常に実行されました。
E_INVALIDARG	1 つ以上のパラメーターが無効です。
E_NOTIMPL	アプリケーションでは、マウスイベントシンクはサポートされていません。

このアドバイスシンクがインストールされると、範囲で指定された範囲にマウスイベントが発生すると、マウスイベントシンク ITfMouseSink::OnMouseEvent メソッドが呼び出されます。

pdwCookie に配置された値は呼び出し元によって保存され、マウスイベントシンクを削除するために ITfMouseTrackerACP::UnadviseMouseSink メソッドに渡されます。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	msctf.h
[DLL]	Msctf.dll
再頒布可能パッケージ	Windows 2000 Professional 上の TSF 1.0