다음을 통해 공유


RecognizerContext 클래스

업데이트: 2007년 11월

잉크 인식을 수행하고 인식 결과 및 대체 항목을 검색하는 기능을 사용하도록 설정합니다. RecognizerContext는 잉크 인식을 사용하여 입력을 적절하게 처리하기 위해 시스템에 설치되는 여러 인식기를 사용하도록 설정합니다.

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

구문

‘선언
<PermissionSetAttribute(SecurityAction.InheritanceDemand, Name := "FullTrust")> _
Public Class RecognizerContext _
    Implements ICloneable, IDisposable
‘사용 방법
Dim instance As RecognizerContext
[PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust")]
public class RecognizerContext : ICloneable, 
    IDisposable
[PermissionSetAttribute(SecurityAction::InheritanceDemand, Name = L"FullTrust")]
public ref class RecognizerContext : ICloneable, 
    IDisposable
/** @attribute PermissionSetAttribute(SecurityAction.InheritanceDemand, Name = "FullTrust") */
public class RecognizerContext implements ICloneable, 
    IDisposable
public class RecognizerContext implements ICloneable, IDisposable

설명

경고

메모리 누수가 발생하지 않도록 하려면 컬렉션이 범위를 벗어나기 전에 이벤트 처리기가 연결되어 있는 모든 RecognizerContext 컬렉션의 Dispose 메서드를 명시적으로 호출해야 합니다.

인식에는 백그라운드(비동기) 인식과 포그라운드(동기) 인식의 두 가지 유형이 있습니다. 백그라운드 인식은 BackgroundRecognize 또는 BackgroundRecognizeWithAlternates 메서드를 호출하면 시작되고, 백그라운드 스레드에서 발생하며, 이벤트 메커니즘을 통해 결과를 응용 프로그램에 보고합니다. 반면 포그라운드 인식은 모든 인식이 완료될 때까지 결과를 반환하지 않으므로 인식 이벤트를 수신 대기하지 않고도 호출 스레드에서 인식 결과를 사용할 수 있습니다.

잉크는 백그라운드에서 지속적으로 처리됩니다. RecognizerContext가 참조하는 Strokes 컬렉션에 Stroke를 추가하면 Stroke가 즉시 인식됩니다. 자세한 내용은 EndInkInput 메서드 항목의 설명을 참조하십시오.

모든 인식은 인식기 컨텍스트를 통해 수행됩니다. 컨텍스트는 단일 인식 세션의 설정을 정의합니다. 즉, 인식해야 하는 잉크를 수신하며 잉크 입력과 인식 출력에 대한 제약 조건을 정의합니다. 컨텍스트에 대해 설정할 수 있는 제약 조건은 사용할 언어, 사전, 문법 등입니다.

참고

Strokes 컬렉션이 nullNull 참조(Visual Basic의 경우 Nothing)인 경우에만 Strokes 또는 CharacterAutoCompletion 속성 이외의 속성을 설정할 수 있습니다. Strokes 컬렉션을 RecognizerContext에 연결하기 전에 다른 속성을 설정하거나, Strokes 컬렉션을 nullNull 참조(Visual Basic의 경우 Nothing)로 설정한 후에 다른 속성을 설정해야 합니다. Strokes 컬렉션을 nullNull 참조(Visual Basic의 경우 Nothing)로 설정한 후에 다른 속성을 설정하는 경우에는 Strokes 컬렉션을 다시 연결해야 할 수 있습니다. 이는 Strokes를 RecognizerContext에 할당한 직후에 인식이 시작되기 때문입니다. Recognize 또는 BackgroundRecognize를 호출하면 호출 결과를 바로 사용할 수 있습니다.

응용 프로그램의 성능을 높이려면 더 이상 사용되지 않는 RecognizerContext 개체를 수동으로 삭제합니다.

상속 계층 구조

System.Object
  Microsoft.Ink.RecognizerContext

스레드로부터의 안전성

이 형식의 모든 공용 static(Visual Basic의 경우 Shared) 멤버는 스레드로부터 안전합니다. 인터페이스 멤버는 스레드로부터 안전하지 않습니다.

플랫폼

Windows Vista

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

버전 정보

.NET Framework

3.0에서 지원

참고 항목

참조

RecognizerContext 멤버

Microsoft.Ink 네임스페이스

Recognizer

Strokes