IInkRecognitionResult インターフェイス (msinkaut.h)

認識の結果を表します。 手書きのインクを認識した結果は、 IInkRecognitionResult オブジェクトで返されます。

継承

IInkRecognitionResult インターフェイスは、IUnknown インターフェイスから継承します。 IInkRecognitionResult には、次の種類のメンバーもあります。

メソッド

IInkRecognitionResult インターフェイスには、これらのメソッドがあります。

IInkRecognitionResult::get_Strokes オブジェクトに含まれている、またはオブジェクトの作成に使用されるストロークのコレクションを取得します。 (IInkRecognitionResult.get_Strokes)
IInkRecognitionResult::get_TopAlternate 認識結果の上位の代替候補を取得します。 (IInkRecognitionResult.get_TopAlternate)
IInkRecognitionResult::get_TopConfidence 認識結果の上位の代替候補を取得します。 (IInkRecognitionResult.get_TopConfidence)
IInkRecognitionResult::get_TopString TopAlternate プロパティの結果テキストを取得します。
IInkRecognitionResult::ModifyTopAlternate 指定した代替を使用して、認識結果の上位の代替を変更します。
IInkRecognitionResult::SetResultOnStrokes 結果の作成に使用されたストロークに認識結果を割り当てます。

注釈

IInkRecognitionAlternate オブジェクトまたは代替オブジェクトは、結果から作成されます。 最適な代替は、結果の既定で使用される代替です。 ただし、 IInkRecognitionResult オブジェクトのメソッドを使用して、結果で使用する代替手段を指定できます。

認識結果がストロークのすべてのコレクションに自動的に割り当てられると、システムのパフォーマンスが低下する可能性があります。 したがって、既定では、結果はストロークのコレクションにアタッチされません。 ストロークのコレクションに結果を割り当てるには、 SetResultOnStrokes メソッドを呼び出す必要があります。

認識結果を保持する唯一の方法は、SetResultOnStrokes を呼び出し、このストロークのコレクションを InkDisp オブジェクトの CustomStrokes コレクションに追加することです。

すべての認識エンジンが TopConfidence プロパティを設定しているわけではありません。 アプリケーションが認識エンジンによって設定されていないプロパティにアクセスしようとすると、引数例外がスローされます。

このインターフェイスを実装するクラスを定義した場合、新しいクラスは Tablet PC アプリケーション プログラミング インターフェイス (API) と正しく対話しません。

メモ ラテン文字と東アジア言語の両方で Microsoft から出荷されるさまざまな手書き認識エンジンは、認識結果として Unicode 値0xFFFFを生成する場合があります。 これは、認識エンジンがインクの一部を有効な文字と一致できない場合に発生します。 0xFFFF コード ポイントは有効な UCS-2 ですが、UTF-8 では使用できません。 認識結果を UTF-8 に変換するアプリケーションでは、0xFFFFを他のコード ポイント (たとえば、0xFFFD) に置き換える必要があります。

 

要件

要件	値
サポートされている最小のクライアント	Windows XP タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー	サポートなし
対象プラットフォーム	Windows
ヘッダー	msinkaut.h

こちらもご覧ください

CustomStrokes プロパティ [InkDisp クラス]

IInkCustomStrokes インターフェイス

IInkRecognizer インターフェイス

InkDisp クラス

InkRecognizerContext クラス

InkStrokes コレクション