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

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

  • Статья

Извлекает список диапазонов точек Юникода, включенных в контексте. Если вы не вызываете функцию SetEnabledUnicodeRanges для указания включенных диапазонов, эта функция возвращает диапазоны точек Юникода по умолчанию распознавателя.

Синтаксис

HRESULT GetEnabledUnicodeRanges(
  HRECOCONTEXT    hrc,
  ULONG           *pcRanges,
  CHARACTER_RANGE *pcr
);

Параметры

hrc

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

pcRanges

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

pcr

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

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

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

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

Комментарии

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

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

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

Требования

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

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

Структура CHARACTER_RANGE

Функция GetUnicodeRanges

Функция SetEnabledUnicodeRanges