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


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

Возвращает диапазоны точек Юникода, поддерживаемые распознавателем.

Синтаксис

HRESULT GetUnicodeRanges(
  HRECOGNIZER     hrec,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Параметры

hrec

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

pcRanges

На входных данных — количество диапазонов, которые может содержать буфер PCR . На выходе — количество диапазонов, содержащихся в буфере PCR .

pcr

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

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

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

Код возврата Описание
S_OK
Успешно.
E_POINTER
Один из параметров является недопустимым указателем.
TPC_E_INSUFFICIENT_BUFFER
Буфер PCR слишком мал.
E_FAIL
Произошла неизвестная ошибка.
E_INVALIDARG
Получен недопустимый аргумент.
E_OUTOFMEMORY
Недостаточно памяти.

Комментарии

Эта функция является необязательной.

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

Для управления диапазонами Юникода, используемыми определенным контекстом распознавателя, используйте функции GetEnabledUnicodeRanges и SetEnabledUnicodeRanges . Эти диапазоны ограничены подмножеством диапазонов, возвращаемых GetUnicodeRanges.

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

Требования

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

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

Функция GetEnabledUnicodeRanges

Функция SetEnabledUnicodeRanges