RecognizerContext.Recognize メソッド

[アーティクル]
10/28/2008

Strokes コレクションの RecognitionResult オブジェクトを返します。

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

構文

'宣言
Public Function Recognize ( _
    <OutAttribute> ByRef recognitionStatus As RecognitionStatus _
) As RecognitionResult
'使用
Dim instance As RecognizerContext
Dim recognitionStatus As RecognitionStatus
Dim returnValue As RecognitionResult

returnValue = instance.Recognize(recognitionStatus)

public RecognitionResult Recognize(
    out RecognitionStatus recognitionStatus
)

public:
RecognitionResult^ Recognize(
    [OutAttribute] RecognitionStatus% recognitionStatus
)

public RecognitionResult Recognize(
    /** @attribute OutAttribute */ /** @ref */RecognitionStatus recognitionStatus
)

public function Recognize(
    recognitionStatus : RecognitionStatus
) : RecognitionResult

パラメータ

recognitionStatus
型 : Microsoft.Ink.RecognitionStatus%
認識中にエラーが発生したかどうかを示し、発生していればどのエラーが発生したかを示す RecognitionStatus 列挙体のメンバ。

戻り値

型 : Microsoft.Ink.RecognitionResult
認識された Strokes コレクションの RecognitionResult オブジェクト。

解説

認識エンジンが Strokes コレクションの結果を計算できない場合、このメソッドは null (Microsoft® Visual Basic® .NET の場合は Nothing) を返します。

メモ :
Ink にストロークが含まれていない場合には例外がスローされるため、Recognize メソッドを呼び出す場合は、try/catch ブロックを使用する必要があります。

このメソッドは、認識を同期的に実行します。バックグラウンドまたは非同期認識を開始するには、BackgroundRecognize メソッドまたは BackgroundRecognizeWithAlternates メソッドを呼び出します。

例

この C# の例では、Button コントロールの Click イベントである buttonSubmit_Click のイベントハンドラを示します。このイベントハンドラは、スコープ内で宣言されている RecognizerContext オブジェクト theRecognizerContext でインクを認識します。エラーがなければ、TextBox コントロールに RecognitionResult オブジェクト theRecognitionResult が表示されます。

private void buttonSubmit_Click(object sender, System.EventArgs e)
{
    RecognitionStatus theRecognitionStatus;
    theRecognizerContext.EndInkInput();
    try
    {
      theRecognitionResult = theRecognizerContext.Recognize(out theRecognitionStatus);
      if (RecognitionStatus.NoError == theRecognitionStatus)
      {
        theTextBox.Text = theRecognitionResult.TopString;
      }
      else
      {
         theTextBox.Text = "";
      }
    }
    catch
    {
      // If Ink object in theRecognizerContext contains no strokes or only
      // deleted strokes, exception is thrown.
      theTextBox.Text = "";
    }
}

この Microsoft® Visual Basic® .NET の例では、Button コントロールの Click イベントである buttonSubmit_Click のイベントハンドラを示します。このイベントハンドラは、スコープ内で宣言されている RecognizerContext オブジェクト theRecognizerContext でインクを認識します。エラーがなければ、TextBox コントロールに RecognitionResult オブジェクト theRecognitionResult が表示されます。

Private Sub Button1_Click( ByVal sender As System.Object, _
  ByVal e As System.EventArgs) Handles Button1.Click
    theRecognizerContext.EndInkInput()
    Dim theRecognitionStatus As RecognitionStatus
    Try
        theRecognitionResult = theRecognizerContext.Recognize(theRecognitionStatus)
        If RecognitionStatus.NoError = theRecognitionStatus Then
            RichTextBox1.Text = theRecognitionResult.TopString
        Else
            'Handle the error conditions here.
            RichTextBox1.Text = ""
        End If
    Catch
        ' If Ink object in theRecognizerContext contains no strokes or only
        ' deleted strokes, exception is thrown.
        RichTextBox1.Text = ""
    End Try
End Sub