다음을 통해 공유


SetTextContext 함수(recapis.h)

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

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

Syntax

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

매개 변수

hrc

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

cwcBefore

pwcBefore의 문자 수입니다.

pwcBefore

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

cwcAfter

pwcAfter의 문자 수입니다.

pwcAfter

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

반환 값

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

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

비고

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

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

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

요구 사항

요구 사항 가치
지원되는 최소 클라이언트 Windows XP 태블릿 PC 버전 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 지원되는 버전 없음
대상 플랫폼 윈도우즈
Header recapis.h
Library inkobjcore.lib
DLL inkobjcore.dll