RecognizerContext.Recognize 메서드

아티클
10/28/2008

업데이트: 2007년 11월

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 개체에 스트로크가 없으면 예외가 throw되므로 Recognize 메서드를 호출할 때는 try/catch 블록을 사용해야 합니다.

이 메서드는 동기 방식으로 인식을 수행합니다. 백그라운드(비동기) 인식을 시작하려면 BackgroundRecognize 또는 BackgroundRecognizeWithAlternates 메서드를 호출합니다.

예제

이 C# 예제에서는 포함되는 범위에서 선언되는 해당 RecognizerContext 개체(theRecognizerContext)의 잉크를 인식하는 Button 컨트롤의 Click 이벤트인 buttonSubmit_Click에 대한 이벤트 처리기를 보여 줍니다. 그런 다음 오류가 발생하지 않으면 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 예제에서는 포함되는 범위에서 선언되는 해당 RecognizerContext 개체(theRecognizerContext)의 잉크를 인식하는 Button 컨트롤의 Click 이벤트인 buttonSubmit_Click에 대한 이벤트 처리기를 보여 줍니다. 그런 다음 오류가 발생하지 않으면 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