SetTextContext 함수(recapis.h)

인식기 컨텍스트에 포함된 텍스트 앞과 뒤의 텍스트 문자열을 제공합니다.

잉크를 처음으로 처리하기 전에 이 함수를 호출합니다. 따라서 Process 함수를 호출하기 전에 SetTextContext 함수를 호출합니다.

구문

HRESULT SetTextContext(
  HRECOCONTEXT hrc,
  ULONG        cwcBefore,
  const WCHAR  *pwcBefore,
  ULONG        cwcAfter,
  const WCHAR  *pwcAfter
);

매개 변수

hrc

인식기 컨텍스트에 대한 핸들입니다.

cwcBefore

pwcBefore의 문자 수입니다.

pwcBefore

인식기 컨텍스트에 포함된 텍스트 앞에 오는 텍스트 문자열입니다. 문자열이 NULL 로 종료되지 않았습니다.

cwcAfter

pwcAfter의 문자 수입니다.

pwcAfter

인식기 컨텍스트에 포함된 텍스트 다음에 오는 텍스트 문자열입니다. 문자열이 NULL -terminated가 아닙니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	성공.
E_POINTER	컨텍스트가 잘못되었거나 매개 변수 중 하나가 잘못된 포인터입니다.
E_NOTIMPL	인식기가 이 함수를 지원하지 않습니다.
E_OUTOFMEMORY	메모리를 할당하여 작업을 완료할 수 없습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	잘못된 인수가 지정되었습니다.

설명

SetTextContext 함수는 구 또는 단어에 대한 컨텍스트를 제공하여 인식기 정확도를 높입니다. 예를 들어 pwcBeforepwcBefore 문자열이 "아래"이고 pwcAfter 문자열이 "집 안"인 경우 문자열 간에 단어 또는 단어를 사용하여 인식기를 편향시킬 수 있습니다. 인식기가 인식을 수행할 때 "the" 뒤와 "in" 이전의 공간을 고려해야 합니다.

그러나 pwcAfter 문자열이 "Hel"이고 pwcBefore 문자열이 "o"인 경우 문자열 간의 공간이 부족하면 인식기가 "Hel"로 시작하고 "o"로 끝나는 단어 내에서 하나 이상의 문자를 인식해야 했음을 나타냅니다.

텍스트 컨텍스트의 길이를 왼쪽 및 오른쪽 컨텍스트에 대해 각각 1024자 이하로 제한하는 것이 좋습니다.

요구 사항

지원되는 최소 클라이언트	Windows XP 태블릿 PC 버전 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	recapis.h
DLL	inkobjcore.dll