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

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

Синтаксис

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

Параметры

hrec

Обработка распознавателя.

pcRanges

При входных данных число диапазонов буфера pcr может храниться. В выходных данных число диапазонов, содержащих буфер pcr .

pcr

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

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

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

Код возврата	Description
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]
минимальный поддерживаемый сервер	Ни одна версия не поддерживается
целевая платформа	Виндоус
Header	recapis.h
Library	inkobjcore.lib
DLL	inkobjcore.dll

См. также

Функция GetEnabledUnicodeRanges

Функция SetEnabledUnicodeRanges