다음을 통해 공유


RecognizerContext.Recognize 메서드

업데이트: 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

매개 변수

반환 값

형식: 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

플랫폼

Windows Vista

.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.

버전 정보

.NET Framework

3.0에서 지원

참고 항목

참조

RecognizerContext 클래스

RecognizerContext 멤버

Microsoft.Ink 네임스페이스

RecognizerContext.BackgroundRecognize

RecognizerContext.BackgroundRecognizeWithAlternates

Ink

Strokes

RecognitionResult.Strokes