SetFactoid 함수(recapis.h)

  • 아티클

인식기가 결과에 대한 검색을 제한하는 데 사용하는 factoid를 지정합니다.

입력 필드에 날짜가 포함된 경우와 같이 입력 필드가 알려진 형식인 경우 factoid를 지정합니다. 잉크를 처음으로 처리하기 전에 이 함수를 호출합니다. 따라서 Process 함수를 호출하기 전에 SetFactoid 함수를 호출합니다.

구문

HRESULT SetFactoid(
  HRECOCONTEXT hrc,
  ULONG        cwcFactoid,
  const WCHAR  *pwcFactoid
);

매개 변수

hrc

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

cwcFactoid

pwcFactoid의 문자 수입니다.

pwcFactoid

인식기 컨텍스트에서 사용할 factoid를 식별합니다. 문자열이 NULL로 종료되지 않았습니다.

반환 값

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

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

설명

cwcFactoid 매개 변수에 전달할 수 있는 factoid 목록은 버전 1에서 지원되는 Factoids를 참조하세요. 해당 항목에 나열된 DEFAULT factoid는 SetFactoid에 전달할 유효한 값이 아닙니다. Tablet PC Platform API는 SetFactoid 함수를 호출하기 전에 DEFAULT를 내부적으로 NULL로 변환합니다.

factoid 문자열의 길이를 32768자 이하로 제한하는 것이 좋습니다.

요구 사항

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

추가 정보

SetFlags 함수