SetEnabledUnicodeRanges 함수(recapis.h)

컨텍스트에서 하나 이상의 유니코드 지점 범위를 사용하도록 설정합니다.

구문

HRESULT SetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           cRanges,
  CHARACTER_RANGE *pcr
);

매개 변수

hrc

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

cRanges

pRanges 버퍼의 범위 수입니다.

pcr

CHARACTER_RANGE 구조체의 배열입니다. 각 구조체는 인식기에서 사용하도록 설정하려는 유니코드 지점의 범위를 식별합니다. 배열의 순서는 임의입니다.

반환 값

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

반환 코드 Description
S_OK
성공.
TPC_S_TRUNCATED
인식기가 지정된 유니코드 지점 범위 중 하나를 지원하지 않습니다.
E_FAIL
지정되지 않은 오류가 발생했습니다.
E_INVALIDARG
잘못된 인수가 수신되었습니다.
E_POINTER
매개 변수 중 하나가 잘못된 포인터입니다.

설명

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

일부 인식기는 특정 코드 포인트의 사용 및 비활성화를 지원하지 않지만 SetEnabledUnicodeRanges 함수를 계속 포함할 수 있습니다. 이러한 인식자의 경우 SetEnabledUnicodeRanges 함수는 E_NOTIMPL 반환합니다.

각 인식기에서 하나 이상의 유니코드 지점 범위를 지원합니다. 인식기가 지원하는 유니코드 지점 범위를 확인하려면 GetUnicodeRanges 함수를 호출합니다. 이 함수를 호출하지 않으면 인식기가 기본 유니코드 지점 범위 집합을 사용합니다. 기본 범위는 인식기별입니다.

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

요구 사항

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

추가 정보

CHARACTER_RANGE 구조체

GetEnabledUnicodeRanges 함수

GetUnicodeRanges 함수