RecognizerContextRecognitionWithAlternatesEventArgs.RecognitionStatus 속성

아티클
11/04/2008

업데이트: 2007년 11월

가장 최근 인식 결과의 인식 상태를 나타내는 RecognitionStatus 열거형 값을 가져옵니다.

네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)

구문

‘선언
Public ReadOnly Property RecognitionStatus As RecognitionStatus
‘사용 방법
Dim instance As RecognizerContextRecognitionWithAlternatesEventArgs
Dim value As RecognitionStatus

value = instance.RecognitionStatus

public RecognitionStatus RecognitionStatus { get; }

public:
property RecognitionStatus RecognitionStatus {
    RecognitionStatus get ();
}

/** @property */
public RecognitionStatus get_RecognitionStatus()

public function get RecognitionStatus () : RecognitionStatus

속성 값

형식: Microsoft.Ink.RecognitionStatus
가장 최근 인식 결과의 인식 상태입니다.

예제

이 예제에서는 InkOverlay 개체에 작성되는 각 스트로크를 자동으로 인식하고 인식 결과를 표시합니다.

사용자가 스트로크를 완성하여 Stroke 이벤트가 발생하면 새로 만들어진 스트로크가 RecognizerContext 개체의 Strokes 컬렉션에 추가되고 customData 매개 변수에 현재 시간을 전달하여 BackgroundRecognizeWithAlternates 메서드가 호출됩니다.

Private Sub mInkOverlay_Stroke3(ByVal sender As Object, ByVal e As InkCollectorStrokeEventArgs)
    ' in case background recognition is still occurring, stop it
    mRecognizerContext.StopBackgroundRecognition()
    ' add the stroke, and start recognition
    mRecognizerContext.Strokes.Add(e.Stroke)
    mRecognizerContext.BackgroundRecognizeWithAlternates(DateTime.Now)
End Sub

private void mInkOverlay_Stroke3(object sender, InkCollectorStrokeEventArgs e)
{
    // in case background recognition is still occurring, stop it
    mRecognizerContext.StopBackgroundRecognition();
    // add the stroke, and start recognition, passing current time
    mRecognizerContext.Strokes.Add(e.Stroke);
    mRecognizerContext.BackgroundRecognizeWithAlternates(DateTime.Now);
}

백그라운드 인식이 완료되면 RecognitionWithAlternates 이벤트가 발생합니다. 이 이벤트를 처리하는 동안 대체 항목을 포함한 인식 결과가 목록 상자에 배치됩니다. 또한 RecognizerContextRecognitionWithAlternatesEventArgs 개체의 CustomData 속성에서 인식이 시작된 시간을 검색하여 인식에 필요한 총 경과 시간을 계산하는 데 사용합니다.

' event fires when recognition results (without alternates) are ready
Private Sub RecognizerContext_Recognition(ByVal sender As Object, _
            ByVal e As RecognizerContextRecognitionEventArgs)
    ' when updating a control, must use Invoke() since controls are
    ' not thread safe and recognition occurs on a different thread
    If Me.InvokeRequired Then
        ' recursively call this method via Invoke()
        Me.Invoke( _
            New RecognizerContextRecognitionEventHandler(AddressOf RecognizerContext_Recognition), _
            New Object() {sender, e} _
        )
        Return
    End If
    If RecognitionStatus.NoError = e.RecognitionStatus Then
        listBoxRecognitionResults.Items.Add(e.Text)
        ' get the custom data and calculate elapsed time
        Dim startTime As DateTime = DirectCast(e.CustomData, DateTime)
        Dim endTime As DateTime = DateTime.Now
        Dim span As TimeSpan = New TimeSpan(endTime.Ticks - startTime.Ticks)
        ' display the number of seconds for this recognition to finish
        listBoxRecognitionResults.Items.Add(span.TotalSeconds.ToString())
    End If
End Sub

// event fires when recognition results (without alternates) are ready
private void RecognizerContext_Recognition(object sender, RecognizerContextRecognitionEventArgs e)
{
    // when updating a control, must use Invoke() since controls are
    // not thread safe and recognition occurs on a different thread
    if (this.InvokeRequired)
    {
        // recursively call this method via Invoke()
        this.Invoke(
            new RecognizerContextRecognitionEventHandler(RecognizerContext_Recognition),
            new object[] { sender, e }
            );
        return;
    }

    if (RecognitionStatus.NoError == e.RecognitionStatus)
    {
        listBoxRecognitionResults.Items.Add(e.Text);
        // get the custom data and calculate elapsed time
        DateTime startTime = (DateTime)e.CustomData;
        DateTime endTime = DateTime.Now;
        TimeSpan span = new TimeSpan(endTime.Ticks - startTime.Ticks);
        // display the number of seconds for this recognition to finish
        listBoxRecognitionResults.Items.Add(span.TotalSeconds.ToString());
    }
}