GetUnicodeRanges 함수(recapis.h)

인식기가 지원하는 유니코드 지점의 범위를 반환합니다.

구문

HRESULT GetUnicodeRanges(
  HRECOGNIZER     hrec,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

매개 변수

hrec

인식기 핸들입니다.

pcRanges

입력에서 pcr 버퍼가 보유할 수 있는 범위의 수입니다. 출력에서 pcr 버퍼에 포함된 범위의 수입니다.

pcr

CHARACTER_RANGE 구조체의 배열입니다. 각 구조체에는 인식기가 지원하는 유니코드 지점의 범위가 포함됩니다. 배열의 순서는 임의입니다. 버퍼의 필요한 크기를 확인하려면 pcr 을 NULL로 설정합니다. 범위 수를 사용하여 pcr 버퍼를 할당합니다.

반환 값

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

반환 코드	Description
S_OK	성공.
E_POINTER	매개 변수 중 하나가 잘못된 포인터입니다.
TPC_E_INSUFFICIENT_BUFFER	pcr 버퍼가 너무 작습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	잘못된 인수가 수신되었습니다.
E_OUTOFMEMORY	메모리가 부족합니다.

설명

이 함수는 선택 사항입니다.

일부 인식기는 이 기능을 지원하지 않지만 GetUnicodeRanges 함수 함수를 계속 포함할 수 있습니다. 이러한 인식자의 경우 GetUnicodeRanges 함수는 E_NOTIMPL 반환합니다.

특정 인식기 컨텍스트에서 사용하는 유니코드 범위를 제어하려면 GetEnabledUnicodeRanges 및 SetEnabledUnicodeRanges 함수를 사용합니다. 이러한 범위는 GetUnicodeRanges에서 반환되는 범위의 하위 집합으로 제한됩니다.

Microsoft 제스처 인식기는 0xF000 0xF0FF 유니코드 문자를 사용합니다. 이 범위의 각 단일 유니코드 값은 단일 제스처를 나타냅니다. 제스처에 대한 유니코드 값의 전체 목록은 제스처의 유니코드 범위 값을 참조하세요.

요구 사항

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

추가 정보

GetEnabledUnicodeRanges 함수

SetEnabledUnicodeRanges 함수