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

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

  • Статья

Предоставляет текстовые строки, которые идут до и после текста, содержащегося в контексте распознавателя.

Эта функция вызывается перед первой обработкой рукописного ввода. Поэтому вызовите функцию SetTextContext перед вызовом функции Process .

Синтаксис

HRESULT SetTextContext(
  HRECOCONTEXT hrc,
  ULONG        cwcBefore,
  const WCHAR  *pwcBefore,
  ULONG        cwcAfter,
  const WCHAR  *pwcAfter
);

Параметры

hrc

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

cwcBefore

Число символов в pwcBefore.

pwcBefore

Текстовая строка, которая находится перед текстом, содержащимся в контексте распознавателя. Строка не заканчивается null .

cwcAfter

Число символов в pwcAfter.

pwcAfter

Текстовая строка, которая появляется после текста, содержащегося в контексте распознавателя. Строка не имеет значение NULL -terminated.

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

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

Код возврата Описание
S_OK
 Успешно.
E_POINTER
 Контекст является недопустимым или один из параметров является недопустимым указателем.
E_NOTIMPL
 Распознаватель не поддерживает эту функцию.
E_OUTOFMEMORY
 Не удалось выделить память для завершения операции.
E_FAIL
 Произошла неизвестная ошибка.
E_INVALIDARG
 Указан недопустимый аргумент.

Комментарии

Функция SetTextContext предоставляет контекст для фразы или слова, повышая точность распознавателя. Например, если строка pwcBeforepwcBefore имеет значение "под " и строка pwcAfter имеет значение "в доме", распознаватель может использовать слово или слова между строками. Распознаватель должен учитывать пробел после "the" и перед "in" при выполнении распознавания.

Однако если строка pwcAfter имеет значение "Hel", а строка pwcBefore — "o", отсутствие пробела между строками указывает на то, что распознаватель должен распознавать одну или несколько букв внутри слова, которое начинается с "Hel" и заканчивается на "o".

Рекомендуется ограничить длину контекста текста не более чем 1024 символами для левого и правого контекстов.

Требования

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