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

IHandwrittenTextInsertion

COM
IID56fdea97-ecd6-43e7-aa3a-816be7785860継承元IUnknown自前メソッド開始 vtbl3

公式ドキュメント

アプリケーションのカスタムテキスト入力コードが、テキストフィールドと Text Services のバッキングストアの両方にテキストを挿入するために使用します。

解説(Remarks)

この要素は Peninputpanel.h で宣言されています。

メソッド 2

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

vtbl 3 HRESULT InsertRecognitionResultsArray(SAFEARRAY* psaAlternates, DWORD locale, BOOL fAlternateContainsAutoSpacingInformation)

認識結果の配列を挿入します。

psaAlternatesSAFEARRAY*in文字列の 2 次元配列です。最初の配列の各エントリは、1 つの単語に対する代替候補のリストです。代替候補のサブ配列の最初のエントリが、挿入するテキスト (最上位の代替候補) です。
localeDWORDin代替候補の生成に使用した認識エンジンの入力言語に対応する、特定のカルチャです。
fAlternateContainsAutoSpacingInformationBOOLin認識されたテキストが自動スペース挿入を有効にして生成されたかどうかを指定します。FALSE の場合、ラティスの先頭/末尾には常にスペースが挿入されます。TRUE の場合、スペースが存在し、必要な箇所にスペースが追加されます。スペースが存在しない場合は、スペースが消費されます。

戻り値

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

解説(Remarks)

この要素は Peninputpanel.h で宣言されています。

vtbl 4 HRESULT InsertInkRecognitionResult(IInkRecognitionResult* pIInkRecoResult, DWORD locale, BOOL fAlternateContainsAutoSpacingInformation)

認識結果を挿入します。

pIInkRecoResultIInkRecognitionResult*inoptional挿入対象の IInkRecognitionResult です。認識結果と、挿入するインクストロークのコレクションが含まれます。
localeDWORDin代替候補の生成に使用した認識エンジンの入力言語に対応する、特定のカルチャのロケール識別子です。
fAlternateContainsAutoSpacingInformationBOOLin認識されたテキストが、認識エンジンで自動スペース挿入を有効にして生成されたかどうかを指定します。自動スペース挿入が有効だった場合は TRUE、それ以外の場合は FALSE です。

戻り値

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

出典・ライセンス: 上記「公式ドキュメント」の内容は 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_IHandwrittenTextInsertion "{56FDEA97-ECD6-43E7-AA3A-816BE7785860}"
#usecom global IHandwrittenTextInsertion IID_IHandwrittenTextInsertion "{9F074EE2-E6E9-4D8A-A047-EB5B5C3C55DA}"
#comfunc global IHandwrittenTextInsertion_InsertRecognitionResultsArray  3 var,int,int
#comfunc global IHandwrittenTextInsertion_InsertInkRecognitionResult     4 sptr,int,int
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。