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

IInkRecognizerContext

COMIDispatch (デュアル)
IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDc68f52f9-32a3-4625-906c-44fc23b40958継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 24

vtbl = vtable インデックス(0始まり)。IDispatch 実装のため HSP ではメソッド名でも呼べます(上記)。低レベルの index 呼び出し用に vtbl も掲載。0〜2 は IUnknown。

vtbl 7 HRESULT get_Strokes(IInkStrokes** Strokes)
StrokesIInkStrokes**out認識対象として設定されているストローク コレクションを受け取るポインタである。
vtbl 8 HRESULT putref_Strokes(IInkStrokes* Strokes)
StrokesIInkStrokes*inoptional認識対象とするストローク コレクションへのポインタである。
vtbl 9 HRESULT get_CharacterAutoCompletionMode(InkRecognizerCharacterAutoCompletionMode* Mode)
ModeInkRecognizerCharacterAutoCompletionMode*out現在の文字オートコンプリート モードを受け取る InkRecognizerCharacterAutoCompletionMode へのポインタである。
vtbl 10 HRESULT put_CharacterAutoCompletionMode(InkRecognizerCharacterAutoCompletionMode Mode)
ModeInkRecognizerCharacterAutoCompletionModein設定する文字オートコンプリート モードを指定する InkRecognizerCharacterAutoCompletionMode 値である。
vtbl 11 HRESULT get_Factoid(LPWSTR* Factoid)
FactoidLPWSTR*out認識精度を高めるために設定されている現在のファクトイド(入力種別ヒント)を文字列で受け取るポインタである。
vtbl 12 HRESULT put_Factoid(LPWSTR factoid)
factoidLPWSTRin認識対象の入力種別を示すファクトイド(例: 数値、メール アドレス等)を文字列で指定する。
vtbl 13 HRESULT get_Guide(IInkRecognizerGuide** RecognizerGuide)
RecognizerGuideIInkRecognizerGuide**out現在設定されている認識ガイド(枠ガイド)を受け取るポインタである。
vtbl 14 HRESULT putref_Guide(IInkRecognizerGuide* RecognizerGuide)
RecognizerGuideIInkRecognizerGuide*inoptional設定する認識ガイド(枠ガイド)へのポインタである。
vtbl 15 HRESULT get_PrefixText(LPWSTR* Prefix)
PrefixLPWSTR*out認識対象の前に付与される接頭テキストを文字列で受け取るポインタである。
vtbl 16 HRESULT put_PrefixText(LPWSTR Prefix)
PrefixLPWSTRin認識のコンテキストとして与える接頭テキストを文字列で指定する。
vtbl 17 HRESULT get_SuffixText(LPWSTR* Suffix)
SuffixLPWSTR*out認識対象の後に付与される接尾テキストを文字列で受け取るポインタである。
vtbl 18 HRESULT put_SuffixText(LPWSTR Suffix)
SuffixLPWSTRin認識のコンテキストとして与える接尾テキストを文字列で指定する。
vtbl 19 HRESULT get_RecognitionFlags(InkRecognitionModes* Modes)
ModesInkRecognitionModes*out現在設定されている認識モード フラグを受け取る InkRecognitionModes へのポインタである。
vtbl 20 HRESULT put_RecognitionFlags(InkRecognitionModes Modes)
ModesInkRecognitionModesin設定する認識モード フラグを指定する InkRecognitionModes 値である。
vtbl 21 HRESULT get_WordList(IInkWordList** WordList)
WordListIInkWordList**out認識に使用されている単語リストを受け取るポインタである。
vtbl 22 HRESULT putref_WordList(IInkWordList* WordList)
WordListIInkWordList*inoptional認識に使用する単語リストへのポインタである。
vtbl 23 HRESULT get_Recognizer(IInkRecognizer** Recognizer)
RecognizerIInkRecognizer**outこのコンテキストに関連付けられた認識エンジンを受け取るポインタである。
vtbl 24 HRESULT Recognize(InkRecognitionStatus* RecognitionStatus, IInkRecognitionResult** RecognitionResult)
RecognitionStatusInkRecognitionStatus*inout認識処理の結果ステータスを受け取る InkRecognitionStatus へのポインタである。
RecognitionResultIInkRecognitionResult**out同期認識によって得られた認識結果を受け取るポインタである。
vtbl 25 HRESULT StopBackgroundRecognition()
vtbl 26 HRESULT EndInkInput()
vtbl 27 HRESULT BackgroundRecognize(VARIANT CustomData)
CustomDataVARIANTin認識完了イベントとともに返される任意のユーザー データを格納した VARIANT である。
vtbl 28 HRESULT BackgroundRecognizeWithAlternates(VARIANT CustomData)
CustomDataVARIANTin代替候補付きのバックグラウンド認識完了イベントとともに返される任意のユーザー データを格納した VARIANT である。
vtbl 29 HRESULT Clone(IInkRecognizerContext** RecoContext)
RecoContextIInkRecognizerContext**outこの認識コンテキストの複製を受け取るポインタである。
vtbl 30 HRESULT IsStringSupported(LPWSTR String, VARIANT_BOOL* Supported)
StringLPWSTRin認識エンジンがサポートしているか確認する文字列を指定する。
SupportedVARIANT_BOOL*out指定した文字列がサポートされているかどうかを受け取る VARIANT_BOOL へのポインタである。

HSP用 COM定義

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

出力引数:
#define global IID_IInkRecognizerContext "{C68F52F9-32A3-4625-906C-44FC23B40958}"
#usecom global IInkRecognizerContext IID_IInkRecognizerContext "{AAC46A37-9229-4FC0-8CCE-4497569BF4D1}"
#comfunc global IInkRecognizerContext_get_Strokes                        7 sptr
#comfunc global IInkRecognizerContext_putref_Strokes                     8 sptr
#comfunc global IInkRecognizerContext_get_CharacterAutoCompletionMode    9 var
#comfunc global IInkRecognizerContext_put_CharacterAutoCompletionMode    10 int
#comfunc global IInkRecognizerContext_get_Factoid                        11 var
#comfunc global IInkRecognizerContext_put_Factoid                        12 wstr
#comfunc global IInkRecognizerContext_get_Guide                          13 sptr
#comfunc global IInkRecognizerContext_putref_Guide                       14 sptr
#comfunc global IInkRecognizerContext_get_PrefixText                     15 var
#comfunc global IInkRecognizerContext_put_PrefixText                     16 wstr
#comfunc global IInkRecognizerContext_get_SuffixText                     17 var
#comfunc global IInkRecognizerContext_put_SuffixText                     18 wstr
#comfunc global IInkRecognizerContext_get_RecognitionFlags               19 var
#comfunc global IInkRecognizerContext_put_RecognitionFlags               20 int
#comfunc global IInkRecognizerContext_get_WordList                       21 sptr
#comfunc global IInkRecognizerContext_putref_WordList                    22 sptr
#comfunc global IInkRecognizerContext_get_Recognizer                     23 sptr
#comfunc global IInkRecognizerContext_Recognize                          24 var,sptr
#comfunc global IInkRecognizerContext_StopBackgroundRecognition          25
#comfunc global IInkRecognizerContext_EndInkInput                        26
#comfunc global IInkRecognizerContext_BackgroundRecognize                27 int
#comfunc global IInkRecognizerContext_BackgroundRecognizeWithAlternates  28 int
#comfunc global IInkRecognizerContext_Clone                              29 sptr
#comfunc global IInkRecognizerContext_IsStringSupported                  30 wstr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※#usecom 末尾は CoCreateInstance 用のクラスID(コクラスCLSID, SDKから自動取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。