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

返されると、認識されたテキストの既知の範囲に対応するストロークのコレクションへのポインターが含まれます。

値を返す

このメソッドは、これらの値のいずれかを返すことができます。

リターンコード	説明
S_OK	成功しました。
E_POINTER	パラメーターに無効なポインターが含まれていました。
E_INK_EXCEPTION	メソッド内で例外が発生しました。
E_FAIL	指定されていないエラーが発生しました。
E_OUTOFMEMORY	ストロークハンドラーヘルパーオブジェクトを割り当てることができません。

注釈

GetStrokesFromTextRange をさらに明確にするために、認識されているストロークのコレクションを検討してください。これらのストロークに最適な代替方法は "お気に入り" です。メソッドに渡されるパラメーターは、この文字列結果の範囲内 (または場合によってはすべて) です。この代替候補には、単語ごとに 1 つずつ、スペースごとに 1 つずつ、5 つのセグメントが含まれています。返されるストロークは、すべての入力範囲を含むセグメントの最小セットに対応します。 selectionStart パラメーターが 0 で、selectionLength パラメーターが 5 の場合、結果文字列の "how a" に対応する範囲を作成すると、返されるストロークはすべて、セグメント "how are" を構成する認識されたストロークになります。これは、入力範囲を含むセグメントの最小セットです。

単語ベースの認識エンジンと文字ベースの認識エンジンの両方で、スペースは文字としてカウントされます。入力選択が空白文字に対応する場合、このメソッドは InkStrokes コレクションを返し、空にします。

必要条件

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