RecognitionAlternate.GetStrokesFromTextRange メソッド

2008-10-28

代替候補内に指定された文字範囲を格納する認識セグメントの最小セットに対応する Strokes コレクションを返します。

名前空間 : Microsoft.Ink
アセンブリ : Microsoft.Ink (Microsoft.Ink.dll 内)

構文

'宣言
Public Function GetStrokesFromTextRange ( _
    ByRef selectionStart As Integer, _
    ByRef selectionLength As Integer _
) As Strokes
'使用
Dim instance As RecognitionAlternate
Dim selectionStart As Integer
Dim selectionLength As Integer
Dim returnValue As Strokes

returnValue = instance.GetStrokesFromTextRange(selectionStart, _
    selectionLength)

public Strokes GetStrokesFromTextRange(
    ref int selectionStart,
    ref int selectionLength
)

public:
Strokes^ GetStrokesFromTextRange(
    int% selectionStart, 
    int% selectionLength
)

public Strokes GetStrokesFromTextRange(
    /** @ref */int selectionStart,
    /** @ref */int selectionLength
)

public function GetStrokesFromTextRange(
    selectionStart : int, 
    selectionLength : int
) : Strokes

パラメータ

selectionStart
型 : System.Int32%
この代替候補内の文字範囲の開始。

selectionLength
型 : System.Int32%
代替候補内の文字範囲の長さ。このパラメータは 0 より大きい値である必要があります。このパラメータは、入力選択を含む 1 つ以上のセグメントの最小セットの長さに調整されます。

戻り値

型 : Microsoft.Ink.Strokes
代替候補内に指定された文字範囲を格納する認識セグメントの最小セットに対応する Strokes コレクションを返します。

解説

selectionStart 位置にある文字は、認識されたテキストの範囲内に含まれます。このパラメータは、入力選択を含む 1 つ以上のセグメントの認識された最小セットの開始に調整されます。selectionStart パラメータは、認識代替候補のテキスト内の文字を指す 0 から始まるインデックスです。

最適な代替候補が "how are you" である認識された Strokes コレクションについて考えます。このメソッドに渡されるパラメータは、この文字列結果の一部 (またはすべて) の範囲です。この代替候補には、それぞれの単語とスペースを合わせて、5 つのセグメントが含まれています。返されるストロークは、すべての入力範囲を含むセグメントの最小セットに対応します。selectionStart パラメータが 0 で、selectionLength が 5 の場合、結果文字列の "how a" に対応する範囲を作成すると、返されるストロークは、セグメント "how are" を構成するすべての認識されたストロークになります。これは、入力範囲を含むセグメントの最小セットです。

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

例

この C# の例では、テキスト範囲を含む RecognitionAlternate オブジェクトの最小セットに関連付けられた Strokes コレクション altStrokes を見つけます。

[C#]

theTextBox.Text = theRecognitionResult.TopString;
//... Assume the user has selected a range within theTextBox.
int selStart = theTextBox.SelectionStart;
int selLength = theTextBox.SelectionLength;
Strokes altStrokes;
altStrokes = theRecognitionResult.TopAlternate.GetStrokesFromTextRange(
    ref selStart, ref selLength);

この Microsoft® Visual Basic® .NET の例では、テキスト範囲を含む RecognitionAlternate オブジェクトの最小セットに関連付けられた Strokes コレクション altStrokes を見つけます。

[Visual Basic]

theTextBox.Text = theRecognitionResult.TopString
'... Assume the user has selected a range within theTextBox.
Dim selStart As Integer = theTextBox.SelectionStart
Dim selLength As Integer = theTextBox.SelectionLength
Dim altStrokes As Strokes
altStrokes = theRecognitionResult.TopAlternate.GetStrokesFromTextRange( _
    selStart, selLength)