InkRecognizerContext 클래스

잉크 인식을 수행하고, 인식 결과를 검색하고, 대체를 검색하는 기능을 사용하도록 설정합니다. InkRecognizerContext를 사용하면 시스템에 설치된 다양한 인식기가 잉크 인식을 사용하여 입력을 적절하게 처리할 수 있습니다.

InkRecognizerContext 에는 다음과 같은 유형의 멤버가 있습니다.

이벤트

InkRecognizerContext 클래스에는 이러한 이벤트가 있습니다.

이벤트 설명
인식 InkRecognizerContext가 BackgroundRecognize 메서드에서 결과를 생성한 경우에 발생합니다.
RecognitionWithAlternates BackgroundRecognizeWithAlternates 메서드를 호출한 후 InkRecognizerContext에서 결과를 생성한 경우에 발생합니다.

인터페이스

InkRecognizerContext 클래스는 이러한 인터페이스를 정의합니다.

인터페이스 설명
IInkRecognizerContext 이 개체는 IInkRecognizerContext COM 인터페이스를 구현합니다.

메서드

InkRecognizerContext 클래스에는 이러한 메서드가 있습니다.

메서드 설명
BackgroundRecognize 인식기가 연결된 스트로크를 인식하고 인식이 완료되면 인식 이벤트를 발생시켜야 한다고 지정합니다.
BackgroundRecognizeWithAlternates 인식기가 연결된 스트로크를 인식하고 인식이 완료되면 RecognitionWithAlternates 이벤트를 발생시켜야 한다고 지정합니다.
복제 중복 된 InkRecognizerContext를 만듭니다.
EndInkInput InkRecognizerContext에 대한 잉크 입력을 종료합니다.
IsStringSupported 시스템 사전, 사용자 사전 또는 단어 목록에 지정된 문자열이 포함되어 있는지 여부를 나타냅니다.
Recognize InkStrokes 컬렉션에서 인식을 수행하고 인식 결과를 반환합니다.
StopBackgroundRecognition BackgroundRecognize 또는BackgroundRecognizeWithAlternates 호출로 시작된 백그라운드 인식을 종료합니다.

속성

InkRecognizerContext 클래스에는 이러한 속성이 있습니다.

속성 액세스 유형 설명
CharacterAutoCompletion
읽기/쓰기
문자 또는 단어가 인식되는 시기를 결정하는 문자 자동 완성 모드를 가져오거나 설정합니다.
Factoid
읽기/쓰기
InkRecognizerContext 개체에서 사용하는 factoid의 문자열 이름을 가져오거나 설정합니다.
가이드
읽기/쓰기
잉크 입력에 사용할 InkRecognizerGuide 를 가져오거나 설정합니다.
PrefixText
읽기/쓰기
InkRecognizerContext 개체의 InkStrokes 컬렉션 앞에 오는 문자를 가져오거나 설정합니다.
RecognitionFlags
읽기/쓰기
인식기가 잉크를 해석하고 결과 문자열을 결정하는 방법을 지정하는 플래그를 가져오거나 설정합니다.
인식기
읽기/쓰기
InkRecognizerContext 개체에서 사용하는 IInkRecognizer 개체를 가져오거나 설정합니다.
스트로크
읽기/쓰기
InkRecognizerContext 개체와 연결된 InkStrokes 컬렉션을 가져오거나 설정합니다.
SuffixText
읽기/쓰기
InkRecognizerContext 개체의 InkStrokes 컬렉션 뒤의 문자를 가져오거나 설정합니다.
Wordlist
읽기/쓰기
인식 결과를 개선하는 데 사용되는 InkWordList 개체를 가져오거나 설정합니다.

설명

이 개체는 C++에서 CoCreateInstance 메서드를 호출하여 인스턴스화할 수 있습니다.

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

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

모든 인식은 인식기 컨텍스트를 통해 발생합니다. 컨텍스트는 단일 인식 세션에 대한 설정을 정의합니다. 인식해야 하는 잉크를 수신하고 잉크 입력 및 인식 출력에 대한 제약 조건을 정의합니다. 컨텍스트에서 설정할 수 있는 제약 조건에는 사용 중인 언어, 사전 및 문법이 포함됩니다.

참고

Strokes 또는 CharacterAutoCompletion 속성 이외의 속성 설정은 InkStrokes 컬렉션이 NULL인 경우에만 성공합니다. InkStrokes 컬렉션을 InkRecognizerContext에 연결하기 전에 다른 속성을 설정하거나 InkStrokes 컬렉션을 NULL 로 설정한 다음 다른 속성을 설정해야 합니다. InkStrokes 컬렉션을 NULL 로 설정한 다음 다른 속성을 설정하는 경우 InkStrokes 컬렉션을 다시 연결해야 할 수 있습니다. InkRecognizerContext에 InkStrokes를 할당한 직후 인식이 시작되기 때문입니다. Recognize 메서드 [InkRecognizeContext 클래스] 또는 BackgroundRecognize를 호출하는 경우 호출 결과를 이미 사용할 수 있습니다.

애플리케이션의 성능을 향상시키려면 더 이상 필요하지 않은 경우 InkRecognizerContext 개체를 삭제합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트
Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버
지원되는 버전 없음
헤더
Msinkaut.h(Msinkaut_i.c 필요)
라이브러리
InkObj.dll

참고 항목

IInkRecognizer 인터페이스

InkStrokes 컬렉션