RecognizerContext.EndInkInput 메서드
업데이트: 2007년 11월
RecognizerContext 개체에 대한 잉크 입력을 종료합니다.
네임스페이스: Microsoft.Ink
어셈블리: Microsoft.Ink(Microsoft.Ink.dll)
구문
‘선언
Public Sub EndInkInput
‘사용 방법
Dim instance As RecognizerContext
instance.EndInkInput()
public void EndInkInput()
public:
void EndInkInput()
public void EndInkInput()
public function EndInkInput()
설명
이 메서드를 호출한 후에는 Stroke 개체를 RecognizerContext 개체에 추가할 수 없습니다.
부분 인식은 모든 잉크를 입력했음을 응용 프로그램에 알리는 EndInkInput 메서드를 응용 프로그램에서 호출하지 않은 경우에도 인식기가 결과를 반환하도록 하는 기능입니다. 부분 인식은 EndInkInput을 호출하기 전에 잉크를 입력했음을 인식기가 확인할 수 있는 경우에만 수행되며, 이 기능을 지원하지 않는 인식기도 있습니다. 부분 인식을 지원하지 않는 인식기는 EndInkInput을 호출해야 결과를 반환합니다.
증분 인식은 인식기가 전달된 잉크의 일부만을 처리하여 결과를 반환하는 기능입니다. 예를 들어 5개의 잉크 줄을 포함하며 라틴 문자 스크립트 인식기를 사용하는 응용 프로그램이 있다고 가정할 경우 인식기는 한 번에 한 줄만을 처리하여 결과를 반환할 수 있습니다. 이 프로세스는 백그라운드 처리 스레드의 유휴 루프에 사용됩니다.
부분 인식을 지원하는 인식기는 EndInkInput 메서드를 호출하지 않은 경우에도 결과를 반환할 수 있습니다.
참고
부분 인식에서 파생되는 결과는 EndInkInput을 호출한 경우의 결과와 다를 수 있습니다. 부분 인식을 사용하면 인식기가 모든 잉크에 대해 결과를 반환하지 않아도 됩니다. 그러나 일부 잉크에 대한 주변 컨텍스트가 손실되면 인식 성능이 떨어질 수 있습니다.
참고
Windows Vista 이상 버전의 경우 이 메서드는 서양 언어 인식기에 대해 더 이상 사용되지 않습니다.
예제
이 C# 예제에서는 포함된 범위에서 선언되는 RecognizerContext인 theRecognizerContext에 할당된 Strokes 컬렉션의 유효한 잉크를 인식하는 단추 컨트롤의 Click 이벤트인 buttonSubmit_Click에 대한 이벤트 처리기를 보여 주며, 오류가 발생하지 않으면 텍스트 상자에 해당 컬렉션을 표시합니다.
private void buttonSubmit_Click(object sender, System.EventArgs e)
{
theRecognizerContext.EndInkInput();
RecognitionStatus theRecognitionStatus;
theRecognitionResult = theRecognizerContext.Recognize(out theRecognitionStatus);
if (RecognitionStatus.NoError == theRecognitionStatus)
theTextBox.Text = theRecognitionResult.TopString;
else
// Handle the error cases here...
theTextBox.Text = "";
}
이 Microsoft Visual Basic® .NET 예제에서는 포함된 범위에서 선언되는 RecognizerContext인 theRecognizerContext에 할당된 Strokes 컬렉션의 유효한 잉크를 인식하는 단추 컨트롤의 Click 이벤트인 buttonSubmit_Click에 대한 이벤트 처리기를 보여 주며, 오류가 발생하지 않으면 텍스트 상자에 해당 컬렉션을 표시합니다.
Private Sub Button1_Click( _
ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
theRecognizerContext.EndInkInput()
Dim theRecognitionStatus As RecognitionStatus
theRecognitionResult = theRecognizerContext.Recognize(theRecognitionStatus)
If RecognitionStatus.NoError = theRecognitionStatus Then
RichTextBox1.Text = theRecognitionResult.TopString
Else
'Handle the error conditions here.
RichTextBox1.Text = ""
End If
End Sub
플랫폼
Windows Vista
.NET Framework 및 .NET Compact Framework에서 모든 플랫폼의 전체 버전을 지원하지는 않습니다. 지원되는 버전의 목록을 보려면 .NET Framework 시스템 요구 사항을 참조하십시오.
버전 정보
.NET Framework
3.0에서 지원