Win32 API 日本語リファレンス
ホームUI.TextServices › ITfKeyEventSink

ITfKeyEventSink

COM
IIDaa80e7f5-2021-11d2-93e0-0060b067b86e継承元IUnknown自前メソッド開始 vtbl3

メソッド 6

vtbl = vtable インデックス(0始まり)。HSP等からCOMメソッドをインデックス指定で呼ぶ際に使用します。0〜2 は IUnknown。

vtbl 3 HRESULT OnSetFocus(BOOL fForeground)
fForegroundBOOLinドキュメントがフォアグラウンドフォーカスを得た場合は TRUE、失った場合は FALSE である。
vtbl 4 HRESULT OnTestKeyDown(ITfContext* pic, WPARAM wParam, LPARAM lParam, BOOL* pfEaten)
picITfContext*inキーイベントが発生したコンテキスト ITfContext へのポインタである。
wParamWPARAMinキーダウンメッセージの WPARAM (仮想キーコード) を指定する。
lParamLPARAMinキーダウンメッセージの LPARAM (キーの状態情報) を指定する。
pfEatenBOOL*outテキストサービスがそのキーを処理する (消費する) 場合に TRUE を設定して受け取る。
vtbl 5 HRESULT OnTestKeyUp(ITfContext* pic, WPARAM wParam, LPARAM lParam, BOOL* pfEaten)
picITfContext*inキーイベントが発生したコンテキスト ITfContext へのポインタである。
wParamWPARAMinキーアップメッセージの WPARAM (仮想キーコード) を指定する。
lParamLPARAMinキーアップメッセージの LPARAM (キーの状態情報) を指定する。
pfEatenBOOL*outテキストサービスがそのキーを処理する (消費する) 場合に TRUE を設定して受け取る。
vtbl 6 HRESULT OnKeyDown(ITfContext* pic, WPARAM wParam, LPARAM lParam, BOOL* pfEaten)
picITfContext*inキーイベントが発生したコンテキスト ITfContext へのポインタである。
wParamWPARAMinキーダウンメッセージの WPARAM (仮想キーコード) を指定する。
lParamLPARAMinキーダウンメッセージの LPARAM (キーの状態情報) を指定する。
pfEatenBOOL*outテキストサービスがそのキーを処理した (消費した) 場合に TRUE を設定して受け取る。
vtbl 7 HRESULT OnKeyUp(ITfContext* pic, WPARAM wParam, LPARAM lParam, BOOL* pfEaten)
picITfContext*inキーイベントが発生したコンテキスト ITfContext へのポインタである。
wParamWPARAMinキーアップメッセージの WPARAM (仮想キーコード) を指定する。
lParamLPARAMinキーアップメッセージの LPARAM (キーの状態情報) を指定する。
pfEatenBOOL*outテキストサービスがそのキーを処理した (消費した) 場合に TRUE を設定して受け取る。
vtbl 8 HRESULT OnPreservedKey(ITfContext* pic, GUID* rguid, BOOL* pfEaten)
picITfContext*inキーイベントが発生したコンテキスト ITfContext へのポインタである。
rguidGUID*in押下された予約済みキーを識別する GUID へのポインタである。
pfEatenBOOL*outテキストサービスがそのキーを処理した (消費した) 場合に TRUE を設定して受け取る。

HSP用 COM定義

#usecom / #comfunc によるHSPのCOM呼び出し定義。数字は vtbl インデックス(0始まり)。クラスIDが無い場合 #usecom の末尾は "{}"、ある場合は "{CLSID}"

出力引数:
#define global IID_ITfKeyEventSink "{AA80E7F5-2021-11D2-93E0-0060B067B86E}"
#usecom global ITfKeyEventSink IID_ITfKeyEventSink "{}"
#comfunc global ITfKeyEventSink_OnSetFocus      3 int
#comfunc global ITfKeyEventSink_OnTestKeyDown   4 sptr,sptr,sptr,var
#comfunc global ITfKeyEventSink_OnTestKeyUp     5 sptr,sptr,sptr,var
#comfunc global ITfKeyEventSink_OnKeyDown       6 sptr,sptr,sptr,var
#comfunc global ITfKeyEventSink_OnKeyUp         7 sptr,sptr,sptr,var
#comfunc global ITfKeyEventSink_OnPreservedKey  8 sptr,var,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。