Функция SetEnabledUnicodeRanges (recapis.h)

Статья
04/11/2023

Включает один или несколько диапазонов точек Юникода в контексте.

Синтаксис

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

Параметры

hrc

Дескриптор контекста распознавателя.

cRanges

Количество диапазонов в буфере pRanges .

pcr

Массив структур CHARACTER_RANGE . Каждая структура определяет диапазон точек Юникода, которые необходимо включить в распознавателье. Порядок массива является произвольным.

Возвращаемое значение

Эта функция может возвращать одно из этих значений.

Код возврата	Описание
S_OK	Успешно.
TPC_S_TRUNCATED	Распознаватель не поддерживает один из указанных диапазонов точек Юникода.
E_FAIL	Произошла неизвестная ошибка.
E_INVALIDARG	Получен недопустимый аргумент.
E_POINTER	Один из параметров является недопустимым указателем.

Некоторые распознавели не поддерживают включение и отключение определенных кодовых точек, но могут по-прежнему включать функцию SetEnabledUnicodeRanges . Для таких распознавителей функция SetEnabledUnicodeRanges возвращает E_NOTIMPL.

Каждый распознаватель поддерживает один или несколько диапазонов точек Юникода. Чтобы определить, какие диапазоны точек Юникода поддерживает распознаватель, вызовите функцию GetUnicodeRanges . Если эта функция не вызывается, распознаватель использует набор диапазонов точек Юникода по умолчанию. Диапазоны по умолчанию зависят от распознавателя.

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

Требования


Минимальная версия клиента	Windows XP Tablet PC Edition [классические приложения \| Приложения UWP]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	recapis.h
DLL	inkobjcore.dll

См. также раздел

Структура CHARACTER_RANGE

Функция GetEnabledUnicodeRanges

Функция GetUnicodeRanges

Поделиться через