SetFlags 함수(recapis.h)

인식기가 잉크를 해석하고 결과 문자열을 결정하는 방법을 지정합니다.

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

구문

HRESULT SetFlags(
  [in] HRECOCONTEXT hrc,
  [in] DWORD        dwFlags
);

매개 변수

[in] hrc

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

[in] dwFlags

다음 표에서는 인식기가 잉크를 해석하고 결과 문자열을 결정하는 방법을 지정하도록 설정할 수 있는 플래그를 나열합니다. OR 연산자(|)를 사용하여 플래그를 적절하게 결합합니다.

비트 플래그	의미
RECOFLAG_AUTOSPACE	Recognizer는 언어 모델 규칙에 따라 스마트 간격을 사용합니다.
RECOFLAG_COERCE	Recognizer는 컨텍스트에 대해 지정한 factoid에 따라 결과를 강제 변환합니다. 예를 들어 전화 번호 factoid를 지정하고 사용자가 "hello"라는 단어를 입력하면 인식기가 난수 전화 번호 또는 빈 문자열을 반환할 수 있습니다. 이 플래그를 지정하지 않으면 인식기가 결과로 "hello"를 반환합니다.
RECOFLAG_PREFIXOK	Recognizer는 기본 또는 지정된(factoid) 언어 모델에 정의된 문자열의 접두사 부분을 인식할 수 있도록 지원합니다. 예를 들어 이 플래그가 없으면 사용자는 "handw"를 쓰고 인식기는 인식기 어휘집에 있는 단어인 제안(예: "hand" 또는 "handed")을 반환합니다. 플래그를 사용하면 인식기 어휘집에 있는 단어 "필기"의 유효한 접두사이므로 인식기는 제안 중 하나로 "handw"를 반환할 수 있습니다. 태블릿 PC 입력 패널은 입력 scope IS_DEFAULT(또는 입력 scope 없음) 또는 사용자 단어 목록이나 정규식이 없는 경우를 제외하고 대부분의 경우에서 이 플래그를 설정합니다. 동아시아 문자 인식기는 호출자가 이 플래그를 통과할 때 E_INVALIDARG 반환해야 합니다.
RECOFLAG_LINEMODE	인식기가 선을 분할하지는 않지만 문자와 단어 분리를 계속 수행해야 합니다. 이는 안내선이 없고 모든 잉크가 한 줄에 있는 것으로 간주된다는 점을 제외하고 줄 바꿈 모드와 동일합니다. 이 플래그를 설정하면 가이드(설정된 경우)가 무시됩니다.
RECOFLAG_SINGLESEG	여러 구분을 사용하지 않도록 설정합니다. 기본적으로 인식기에서는 잉크에 대한 여러 구분(대체)을 반환합니다. 예를 들어 "함께"를 별도의 스트로크로 작성하는 경우 인식기가 잉크를 "get her", "to gather" 또는 "together"로 분할할 수 있습니다. 대체 항목을 쿼리할 때 잉크를 여러 번 구분할 필요가 없는 경우 이 플래그를 설정합니다. 이렇게 하면 성능이 향상되고 메모리 사용량이 줄어듭니다.
RECOFLAG_WORDMODE	Recognizer는 잉크를 단일 단어로 처리합니다. 예를 들어 컨텍스트에 "to get her"가 포함되어 있으면 인식기가 "함께"를 반환합니다.

반환 값

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

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

설명

Microsoft Windows XP 태블릿 PC 버전 개발 키트 1.7 이전에는 태블릿 PC 입력 패널이 스마트 간격을 수행했습니다. 태블릿 PC SDK 1.7부터 입력 패널은 예비 간격 권장 사항으로 결과를 계속 생성합니다. 그러나 태블릿 PC 입력 패널의 간격 결과는 인식기 권장 사항(결과)에 의해 변경될 수 있습니다. 인식기는 입력 패널에서 수행한 SetTextContext 호출에 따라 텍스트 컨텍스트 정보 및 내부 언어 모델 규칙을 사용하여 이 작업을 수행할 수 있습니다.

입력 패널은 RECOFLAG_AUTOSPACE 플래그 집합을 사용하여 이 함수를 호출하여 인식기가 자동 간격을 수행할 수 있는지 여부를 확인할 수 있습니다. 인식기가 자동 간격을 지원하지 않으면 E_INVALIDARG 반환됩니다.

참고SetFlags 함수에서는 줄 모드만 지원됩니다. Boxed 모드, 무료 모드 및 단일 줄 모드는 지원되지 않습니다.

 

요구 사항

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

추가 정보

SetFactoid 함수

SetTextContext 함수