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 버전 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
지원되는 버전 없음 |
| 헤더 |
|