GetUnicodeRanges 함수(recapis.h)
인식기가 지원하는 유니코드 지점의 범위를 반환합니다.
구문
HRESULT GetUnicodeRanges(
HRECOGNIZER hrec,
ULONG *pcRanges,
CHARACTER_RANGE *pcr
);
매개 변수
hrec
인식기 핸들입니다.
pcRanges
입력에서 pcr 버퍼가 보유할 수 있는 범위의 수입니다. 출력에서 pcr 버퍼에 포함된 범위의 수입니다.
pcr
CHARACTER_RANGE 구조체의 배열입니다. 각 구조체에는 인식기가 지원하는 유니코드 지점의 범위가 포함됩니다. 배열의 순서는 임의입니다. 버퍼의 필요한 크기를 확인하려면 pcr 을 NULL로 설정합니다. 범위 수를 사용하여 pcr 버퍼를 할당합니다.
반환 값
이 함수는 이러한 값 중 하나를 반환할 수 있습니다.
반환 코드 | Description |
---|---|
|
성공. |
|
매개 변수 중 하나가 잘못된 포인터입니다. |
|
pcr 버퍼가 너무 작습니다. |
|
지정되지 않은 오류가 발생했습니다. |
|
잘못된 인수가 수신되었습니다. |
|
메모리가 부족합니다. |
설명
이 함수는 선택 사항입니다.
일부 인식기는 이 기능을 지원하지 않지만 GetUnicodeRanges 함수 함수를 계속 포함할 수 있습니다. 이러한 인식자의 경우 GetUnicodeRanges 함수는 E_NOTIMPL 반환합니다.
특정 인식기 컨텍스트에서 사용하는 유니코드 범위를 제어하려면 GetEnabledUnicodeRanges 및 SetEnabledUnicodeRanges 함수를 사용합니다. 이러한 범위는 GetUnicodeRanges에서 반환되는 범위의 하위 집합으로 제한됩니다.
Microsoft 제스처 인식기는 0xF000 0xF0FF 유니코드 문자를 사용합니다. 이 범위의 각 단일 유니코드 값은 단일 제스처를 나타냅니다. 제스처에 대한 유니코드 값의 전체 목록은 제스처의 유니코드 범위 값을 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
지원되는 최소 클라이언트 | Windows XP 태블릿 PC 버전 [데스크톱 앱 | UWP 앱] |
지원되는 최소 서버 | 지원되는 버전 없음 |
대상 플랫폼 | Windows |
헤더 | recapis.h |
DLL | inkobjcore.dll |