Функция 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 . Если эта функция не вызывается, распознаватель использует набор диапазонов точек Юникода по умолчанию. Диапазоны по умолчанию относятся к распознавателям.

Распознаватель жестов Майкрософт использует символы Юникода из 0xF000 для 0xF0FF. Каждое одно значение Юникода в этом диапазоне представляет собой один жест. Полный список значений Юникода для жестов см. в разделе "Значения диапазона юникодов" жестов.

Требования

Требование	Ценность
Минимальный поддерживаемый клиент	Windows XP Tablet PC Edition [классические приложения | Приложения UWP]
минимальный поддерживаемый сервер	Ни одна версия не поддерживается
целевая платформа	Виндоус
Header	recapis.h
Library	inkobjcore.lib
DLL	inkobjcore.dll

См. также

Структура CHARACTER_RANGE

Функция GetEnabledUnicodeRanges

Функция GetUnicodeRanges