ホーム › UI.TextServices › ITfFnConfigureRegisterWord

ITfFnConfigureRegisterWord

COM

IIDbb95808a-6d8f-4bca-8400-5390b586aedf継承元ITfFunction自前メソッド開始 vtbl4

公式ドキュメント

ITfFnConfigureRegisterWord インターフェイスはテキストサービスによって実装され、Active Input Method Editor (IME) がテキストサービスに単語登録ダイアログボックスを表示させることを可能にします。

メソッド 1

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

vtbl 4 HRESULT Show(HWND hwndParent, WORD langid, GUID* rguidProfile, LPWSTR bstrRegistered)

ITfFnConfigureRegisterWord::Show メソッド

hwndParent	HWND	in	親ウィンドウのハンドルです。テキストサービスは通常、ダイアログボックスを作成する際にこれを親ウィンドウまたはオーナーウィンドウとして使用します。
langid	WORD	in	Input Method Editor (IME) が現在使用している言語の識別子を指定する LANGID を格納します。
rguidProfile	GUID*	in	テキストサービスが属する言語プロファイル識別子を指定する GUID を格納します。これは、プロファイルが追加されたときに ITfInputProcessorProfiles::AddLanguageProfile で指定された値です。
bstrRegistered	LPWSTR	in	テキストサービスに登録する単語を格納する BSTR を指定します。これは省略可能で、NULL を指定できます。NULL の場合、テキストサービスは既定の単語登録ダイアログボックスを表示する必要があります。

戻り値

このメソッドは、次のいずれかの値を返します。

値	説明
S_OK	メソッドは成功しました。
E_NOTIMPL	テキストサービスはこのメソッドを実装していません。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)

HSP用 COM定義

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

出力引数:

#define global IID_ITfFnConfigureRegisterWord "{BB95808A-6D8F-4BCA-8400-5390B586AEDF}"
#usecom global ITfFnConfigureRegisterWord IID_ITfFnConfigureRegisterWord "{}"
#comfunc global ITfFnConfigureRegisterWord_Show  4 sptr,int,var,wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。#define global IID_ITfFnConfigureRegisterWord "{BB95808A-6D8F-4BCA-8400-5390B586AEDF}"
#usecom global ITfFnConfigureRegisterWord IID_ITfFnConfigureRegisterWord "{}"
#comfunc global ITfFnConfigureRegisterWord_Show  4 sptr,int,sptr,wstr
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数はポインタ方式(token=sptr / 呼び出しは varptr(変数))。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。