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

ITfInputScope

COM
📘 Microsoft Learn (日本語) · English
IIDfde1eaee-6924-4cdf-91e7-da38cff5559d継承元IUnknown自前メソッド開始 vtbl3

メソッド 5

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

vtbl 3 HRESULT GetInputScopes(InputScope** pprgInputScopes, DWORD* pcCount)
pprgInputScopesInputScope**out入力スコープ (InputScope) の配列を受け取るポインタへのポインタである。呼び出し側が解放する。
pcCountDWORD*out返された入力スコープの個数を受け取る DWORD へのポインタである。
vtbl 4 HRESULT GetPhrase(LPWSTR** ppbstrPhrases, DWORD* pcCount)
ppbstrPhrasesLPWSTR**out入力候補となるフレーズ文字列の配列を受け取るポインタへのポインタである。呼び出し側が解放する。
pcCountDWORD*out返されたフレーズの個数を受け取る DWORD へのポインタである。
vtbl 5 HRESULT GetRegularExpression(LPWSTR* pbstrRegExp)
pbstrRegExpLPWSTR*out入力を制約する正規表現文字列を受け取る LPWSTR (BSTR) へのポインタである。
vtbl 6 HRESULT GetSRGS(LPWSTR* pbstrSRGS)
pbstrSRGSLPWSTR*out音声認識文法を表す SRGS 文字列を受け取る LPWSTR (BSTR) へのポインタである。
vtbl 7 HRESULT GetXML(LPWSTR* pbstrXML)
pbstrXMLLPWSTR*out入力スコープを表す XML 文字列を受け取る LPWSTR (BSTR) へのポインタである。

HSP用 COM定義

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

出力引数: 
#define global IID_ITfInputScope "{FDE1EAEE-6924-4CDF-91E7-DA38CFF5559D}"
#usecom global ITfInputScope IID_ITfInputScope "{}"
#comfunc global ITfInputScope_GetInputScopes        3 var,var
#comfunc global ITfInputScope_GetPhrase             4 var,var
#comfunc global ITfInputScope_GetRegularExpression  5 var
#comfunc global ITfInputScope_GetSRGS               6 var
#comfunc global ITfInputScope_GetXML                7 var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。