SetGuide 함수(recapis.h)

박스형 또는 줄 지어 입력에 사용할 인식 가이드를 설정합니다. 컨텍스트에 스트로크를 추가하기 전에 이 함수를 호출해야 합니다.

구문

HRESULT SetGuide(
  HRECOCONTEXT     hrc,
  const RECO_GUIDE *pGuide,
  ULONG            iIndex
);

hrc

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

pGuide

상자 또는 줄 입력에 사용할 가이드입니다. 이 매개 변수를 NULL 로 설정하면 컨텍스트에 지침이 없음을 의미합니다. 이는 기본값이며 인식기가 무료 입력 모드임을 의미합니다. 가이드 세부 정보는 RECO_GUIDE 구조를 참조하세요.

iIndex

컨텍스트의 첫 번째 상자 또는 줄에 사용할 인덱스 값입니다.

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

반환 코드	Description
S_OK	성공.
E_POINTER	컨텍스트가 잘못되었거나 매개 변수 중 하나가 잘못된 포인터입니다.
E_OUTOFMEMORY	작업을 완료하기 위해 메모리를 할당할 수 없습니다.
E_INVALIDARG	인식기에서 지원되지 않는 인식 모드(무료, 줄 지어 있음, 박스형 등)를 설정하려고 시도했거나 RECO_GUIDE 필드 값이 잘못되었습니다(예: 음의 높이 또는 너비).
E_FAIL	지정되지 않은 오류가 발생했습니다.
TPC_E_OUT_OF_ORDER_CALL	reco 컨텍스트에 이미 일부 잉크가 있거나 동아시아 문자 인식기의 경우 SetCACMode 가 이전에 호출된 경우 가이드를 설정하려고 했습니다.

안내선 상자는 iIntex 값에 따라 번호가 매겨집니다.

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