IInkRecognitionAlternate::GetStrokesFromStrokeRanges メソッド (msinkaut.h)
既知の入力 InkStrokes コレクションを含み、 IInkRecognizer オブジェクトが代替を提供できる最小の InkStrokes コレクションを取得します。
構文
HRESULT GetStrokesFromStrokeRanges(
[in] IInkStrokes *Strokes,
[out, retval] IInkStrokes **GetStrokesFromStrokeRanges
);
パラメーター
[in] Strokes
このコレクションを含む認識結果代替の最小ストローク コレクションを検索するために使用するストローク オブジェクトのコレクション。
[out, retval] GetStrokesFromStrokeRanges
このメソッドが戻るとき、 には、ストロークの既知の入力コレクションを含み、認識エンジンが代替を提供できるストロークの最小コレクションへのポインターが含まれます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
メソッド内で例外が発生しました。 |
|
strokes パラメーターは、別の Ink オブジェクトに関連付けられています。 |
|
未指定のエラーが発生しました。 |
解説
返されるコレクションは入力コレクションと一致する場合があります。または、入力コレクションが、すべての入力ストロークを含む最小の認識結果の一部にのみ一致する場合は、大きくなる可能性があります。
このメソッドは、1 回のクリックで単語を選択する場合に最も便利です。 たとえば、クリックした単語を構成するストロークを返すには、ストロークをクリックし、IInkStrokeDisp オブジェクトの HitTest メソッドを呼び出してクリックしたストロークを取得し、GetStrokesFromStrokeRanges を呼び出します。
ストローク範囲は、 InkDisp オブジェクトが変更されるまで有効です。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |