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

IInkRecognitionAlternate

COMIDispatch (デュアル)
📘 Microsoft Learn (日本語) · English
✅ IDispatch を実装(デュアルインターフェース)。HSP では comobj 経由でメソッド名による遅延バインド呼び出しができます(vtableインデックス不要)。
IIDb7e660ad-77e4-429b-adda-873780d1fc4a継承元IDispatch呼び出し名前(IDispatch) または vtbl自前メソッド開始 vtbl7

メソッド 15

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

vtbl 7 HRESULT get_String(LPWSTR* RecoString)
RecoStringLPWSTR*outこの代替候補の認識文字列を受け取るポインタである。
vtbl 8 HRESULT get_Confidence(InkRecognitionConfidence* Confidence)
ConfidenceInkRecognitionConfidence*outこの代替候補の認識信頼度(強・中・弱)を受け取る InkRecognitionConfidence へのポインタである。
vtbl 9 HRESULT get_Baseline(VARIANT* Baseline)
BaselineVARIANT*out認識された文字のベースラインを表す点配列を受け取る VARIANT へのポインタである。
vtbl 10 HRESULT get_Midline(VARIANT* Midline)
MidlineVARIANT*out認識された文字のミッドライン(中線)を表す点配列を受け取る VARIANT へのポインタである。
vtbl 11 HRESULT get_Ascender(VARIANT* Ascender)
AscenderVARIANT*out認識された文字のアセンダー線を表す点配列を受け取る VARIANT へのポインタである。
vtbl 12 HRESULT get_Descender(VARIANT* Descender)
DescenderVARIANT*out認識された文字のディセンダー線を表す点配列を受け取る VARIANT へのポインタである。
vtbl 13 HRESULT get_LineNumber(INT* LineNumber)
LineNumberINT*outこの代替候補が属する行番号を受け取るポインタである。
vtbl 14 HRESULT get_Strokes(IInkStrokes** Strokes)
StrokesIInkStrokes**outこの代替候補に対応するストローク コレクションを受け取るポインタである。
vtbl 15 HRESULT get_LineAlternates(IInkRecognitionAlternates** LineAlternates)
LineAlternatesIInkRecognitionAlternates**out行単位での代替候補のコレクションを受け取るポインタである。
vtbl 16 HRESULT get_ConfidenceAlternates(IInkRecognitionAlternates** ConfidenceAlternates)
ConfidenceAlternatesIInkRecognitionAlternates**out信頼度の境界ごとにグループ化された代替候補のコレクションを受け取るポインタである。
vtbl 17 HRESULT GetStrokesFromStrokeRanges(IInkStrokes* Strokes, IInkStrokes** GetStrokesFromStrokeRanges)
StrokesIInkStrokes*inoptional対象範囲を指定するストローク コレクションへのポインタである。
GetStrokesFromStrokeRangesIInkStrokes**out指定したストローク範囲に対応するストローク コレクションを受け取るポインタである。
vtbl 18 HRESULT GetStrokesFromTextRange(INT* selectionStart, INT* selectionLength, IInkStrokes** GetStrokesFromTextRange)
selectionStartINT*inout入力として文字選択範囲の開始位置を渡し、ストロークに合わせて調整された開始位置を受け取るポインタである。
selectionLengthINT*inout入力として文字選択範囲の長さを渡し、ストロークに合わせて調整された長さを受け取るポインタである。
GetStrokesFromTextRangeIInkStrokes**out指定したテキスト範囲に対応するストローク コレクションを受け取るポインタである。
vtbl 19 HRESULT GetTextRangeFromStrokes(IInkStrokes* Strokes, INT* selectionStart, INT* selectionLength)
StrokesIInkStrokes*inoptionalテキスト範囲を求める対象のストローク コレクションへのポインタである。
selectionStartINT*inout指定ストロークに対応する文字選択範囲の開始位置を受け取るポインタである。
selectionLengthINT*inout指定ストロークに対応する文字選択範囲の長さを受け取るポインタである。
vtbl 20 HRESULT AlternatesWithConstantPropertyValues(LPWSTR PropertyType, IInkRecognitionAlternates** AlternatesWithConstantPropertyValues)
PropertyTypeLPWSTRin代替候補をグループ化する基準となるプロパティの GUID 文字列を指定する。
AlternatesWithConstantPropertyValuesIInkRecognitionAlternates**out指定プロパティ値が一定となる代替候補のコレクションを受け取るポインタである。
vtbl 21 HRESULT GetPropertyValue(LPWSTR PropertyType, VARIANT* PropertyValue)
PropertyTypeLPWSTRin値を取得するプロパティの GUID 文字列を指定する。
PropertyValueVARIANT*out指定したプロパティの値を受け取る VARIANT へのポインタである。

HSP用 COM定義

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

出力引数: 
#define global IID_IInkRecognitionAlternate "{B7E660AD-77E4-429B-ADDA-873780D1FC4A}"
#usecom global IInkRecognitionAlternate IID_IInkRecognitionAlternate "{}"
#comfunc global IInkRecognitionAlternate_get_String                            7 var
#comfunc global IInkRecognitionAlternate_get_Confidence                        8 var
#comfunc global IInkRecognitionAlternate_get_Baseline                          9 var
#comfunc global IInkRecognitionAlternate_get_Midline                           10 var
#comfunc global IInkRecognitionAlternate_get_Ascender                          11 var
#comfunc global IInkRecognitionAlternate_get_Descender                         12 var
#comfunc global IInkRecognitionAlternate_get_LineNumber                        13 var
#comfunc global IInkRecognitionAlternate_get_Strokes                           14 sptr
#comfunc global IInkRecognitionAlternate_get_LineAlternates                    15 sptr
#comfunc global IInkRecognitionAlternate_get_ConfidenceAlternates              16 sptr
#comfunc global IInkRecognitionAlternate_GetStrokesFromStrokeRanges            17 sptr,sptr
#comfunc global IInkRecognitionAlternate_GetStrokesFromTextRange               18 var,var,sptr
#comfunc global IInkRecognitionAlternate_GetTextRangeFromStrokes               19 sptr,var,var
#comfunc global IInkRecognitionAlternate_AlternatesWithConstantPropertyValues  20 wstr,sptr
#comfunc global IInkRecognitionAlternate_GetPropertyValue                      21 wstr,var
; ※数字は vtbl インデックス(0始まり)。0/1/2 は IUnknown(QueryInterface/AddRef/Release)。
; ※このインターフェースは直接 CoCreateInstance するクラスIDが無いため "{}"(他メソッド/アクティベーションで取得)。
; ※出力/バッファ引数は var(変数直渡し)。varptr 方式にも切替可。
; ※ハンドル/void*等の不透明ポインタは IronHSP では intptr 指定が可能。
; ※IDispatch 実装。HSP では comobj 経由でメソッド名による呼び出しも可能(vtbl 不要)。