HRECOCONTEXT 핸들

HRECOCONTEXT 핸들은 컨텍스트에 잉크를 추가하고, 잉크 인식을 수행하고(동기적으로 또는 비동기적으로) 인식 결과를 검색하고, 대체 항목을 검색하는 데 사용됩니다.

인식기 컨텍스트 핸들이 있는 주된 이유는 잉크 입력을 구분하기 위해서입니다. 예를 들어 두 개의 창으로 애플리케이션을 만들 수 있습니다. 사용자는 두 창에서 잉크를 입력할 수 있습니다. 창 중 하나의 잉크를 인식하도록 인식기를 요청할 때 첫 번째 창의 잉크를 두 번째 창의 잉크와 혼합하지 않도록 합니다. 이러한 종류의 애플리케이션에서는 두 개의 인식기 컨텍스트(각 창마다 하나씩)를 만들고 창 1에 들어오는 스트로크를 인식기 컨텍스트 1에 추가하고 창 2의 스트로크를 인식기 컨텍스트 2에 추가합니다. 인식 결과를 반환하려면 창 1 또는 2에 대한 결과를 원하는지에 따라 인식기 컨텍스트 1 또는 인식기 컨텍스트 2에서 프로세스를 호출합니다.

인식기 컨텍스트 핸들은 원하는 모든 항목이 될 수 있습니다. 그러나 일반적으로 구조체의 전역 배열에 있는 인덱스입니다. 구조체에는 입력된 모든 스트로크와 인식기가 특정 잉크 조각에 사용하는 모든 변수(예: 내부 격자 구조 또는 현재 인식 상태)가 포함될 수 있습니다. 하나의 구조체에는 인식기가 필요로 하고 특정 잉크 조각에 사용하는 모든 정보가 포함될 수 있습니다.

HRECOCONTEXT 핸들을 얻으려면 CreateContext 함수를 호출합니다.

typedef HANDLE HRECOCONTEXT;

설명

다음은 HRECOCONTEXT 함수입니다.

함수	설명
AddStroke	인식기 컨텍스트에 잉크 스트로크를 추가합니다.
AdviseInkChange	새 스트로크가 추가되거나 삭제되므로 인식기가 잉크 처리를 중지합니다.
CloneContext	원본과 동일한 설정을 포함하는 인식기 컨텍스트를 만듭니다. 새 인식기 컨텍스트에는 원본의 잉크 또는 인식 결과가 포함되지 않습니다.
EndInkInput	컨텍스트에 더 이상 잉크가 추가되지 않음을 나타냅니다.
GetAlternateList	최상의 결과 문자열에 대한 대체 항목 목록을 반환합니다.
GetBestAlternate	최상의 결과 대체 항목에 대한 HRECOALT 핸들 포인터를 반환합니다.
GetBestResultString	최상의 결과 문자열을 반환합니다.
GetContextPropertyList	인식기가 지원하는 속성 목록을 반환합니다.
GetContextPropertyValue	인식기 컨텍스트에서 지정된 속성 값을 반환합니다.
GetEnabledUnicodeRanges	컨텍스트에서 사용하도록 설정된 유니코드 지점 범위 목록을 반환합니다.
GetGuide	박스형 또는 줄 지어 입력에 사용되는 가이드를 반환합니다.
GetLatticePtr	현재 결과의 격자에 대한 포인터를 반환합니다.
IsStringSupported	전달된 단어, 날짜, 시간, 숫자 또는 기타 텍스트가 사전에 포함되어 있는지 여부를 나타내는 값을 반환합니다.
프로세스	잉크 인식을 동기적으로 수행합니다.
ResetContext	컨텍스트에서 현재 잉크 및 인식 결과를 삭제합니다.
SetCACMode	문자 또는 단어 인식에 대한 문자 자동 완성 모드를 지정합니다.
SetContextPropertyValue	인식기 컨텍스트에 속성을 추가합니다. 속성이 이미 있는 경우 해당 값이 수정됩니다.
SetEnabledUnicodeRanges	컨텍스트에서 하나 이상의 유니코드 지점 범위를 사용하도록 설정합니다.
SetFactoid	인식기가 결과에 대한 검색을 제한하는 데 사용하는 factoid를 설정합니다.
SetFlags	인식기가 잉크를 해석하고 결과 문자열을 결정하는 방법을 설정합니다.
SetGuide	박스형 또는 줄 지어 입력에 사용할 가이드를 설정합니다.
SetTextContext	인식기 컨텍스트에 포함된 텍스트 앞과 뒤의 텍스트 문자열을 제공합니다. 동아시아 문자 인식기의 경우 SetTextContext 함수는 텍스트 문자열이 아닌 문자를 제공합니다.
SetWordList	인식할 현재 인식기 컨텍스트의 단어 목록을 설정합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
헤더	Recapis.h