GetEnabledUnicodeRanges 함수(recapis.h)

  • 아티클

컨텍스트에서 사용하도록 설정된 유니코드 지점 범위 목록을 검색합니다. SetEnabledUnicodeRanges 함수를 호출하여 사용 범위를 지정하지 않으면 이 함수는 인식기 기본 유니코드 점 범위를 반환합니다.

구문

HRESULT GetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

매개 변수

hrc

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

pcRanges

입력에서 pcr 버퍼에 포함될 수 있는 CHARACTER_RANGE 구조체의 수입니다. 출력에서 pcr 버퍼에 포함된 범위의 수입니다.

pcr

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

반환 값

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

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

설명

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

일부 인식기는 특정 유니코드 지점의 사용 및 비활성화를 지원하지 않지만 여전히 GetEnabledUnicodeRanges 함수를 포함할 수 있습니다. 이러한 인식자의 경우 GetEnabledUnicodeRanges 함수는 GetUnicodeRanges 함수와 동일한 범위를 반환합니다.

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

요구 사항

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

추가 정보

CHARACTER_RANGE 구조체

GetUnicodeRanges 함수

SetEnabledUnicodeRanges 함수