IInkRecognitionAlternate::GetStrokesFromTextRange メソッド (msinkaut.h)
代替内の指定した文字範囲を含む認識セグメントの最小セットに対応するコレクションを取得します。
構文
HRESULT GetStrokesFromTextRange(
[in, out] long *selectionStart,
[in, out] long *selectionLength,
[out, retval] IInkStrokes **GetStrokesFromTextRange
);
パラメーター
[in, out] selectionStart
この代替内の文字範囲の先頭。 selectionStart 位置の文字は、認識されたテキストの範囲に含まれます。 このパラメーターは、入力選択を含む 1 つ以上のセグメントの最小認識セットの先頭に調整されます。 selectionStart パラメーターは、認識代替テキストの文字に対する 0 から始まるインデックスです。
[in, out] selectionLength
代替内の文字範囲の長さ。 このパラメーターは 0 より大きくする必要があります。 このパラメーターは、入力選択を含む 1 つ以上のセグメントの最小セットの長さに調整されます。
[out, retval] GetStrokesFromTextRange
が返されると、認識されたテキストの既知の範囲に対応するストロークのコレクションへのポインターが含まれます。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
| リターン コード | 説明 |
|---|---|
|
正常終了しました。 |
|
パラメーターに無効なポインターが含まれていました。 |
|
メソッド内で例外が発生しました。 |
|
未指定のエラーが発生しました。 |
|
ストローク ハンドラー ヘルパー オブジェクトを割り当てることができません。 |
注釈
GetStrokesFromTextRange をさらに明確にするために、認識されたストロークのコレクションと、それらのストロークの最適な代替手段は "方法" であると考えてください。 メソッドに渡されるパラメーターは、この文字列の結果の範囲内 (またはすべての範囲内) です。 この代替には、単語ごとに 1 つ、スペースごとに 1 つずつ、5 つのセグメントが含まれています。 返されるストロークは、すべての入力範囲を含むセグメントの最小セットに対応します。 selectionStart パラメーターが 0 で、selectionLength パラメーターが 5 の場合、結果文字列の "how a" に対応する範囲を作成すると、返されるストロークはすべて、セグメント "how are" を構成する認識されたストロークになります。 これは、入力範囲を含むセグメントの最小セットです。
単語ベースの認識エンジンと文字ベースの認識エンジンの両方で、スペースは文字としてカウントされます。 入力選択がスペース文字に対応する場合、このメソッドは InkStrokes コレクションを返し、空 の InkStrokes コレクションを 返します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP タブレット PC エディション [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | サポートなし |
| 対象プラットフォーム | Windows |
| ヘッダー | msinkaut.h |
| Library | InkObj.dll |