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

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

  • Статья

Задает руководство по распознаванию, используемое для ввода в виде коробок или линии. Эту функцию необходимо вызвать перед добавлением штрихов в контекст.

Синтаксис

HRESULT SetGuide(
  HRECOCONTEXT     hrc,
  const RECO_GUIDE *pGuide,
  ULONG            iIndex
);

Параметры

hrc

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

pGuide

Руководство по использованию для ввода поля или строки. Установка для этого параметра значения NULL означает, что контекст не имеет направляющей. Это значение по умолчанию и означает, что распознаватель находится в режиме свободного ввода. Дополнительные сведения см. в разделе структура RECO_GUIDE .

iIndex

Значение индекса, используемое для первого поля или строки в контексте.

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

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

Код возврата Описание
S_OK
 Успешно.
E_POINTER
 Контекст является недопустимым или один из параметров является недопустимым указателем.
E_OUTOFMEMORY
 Не удалось выделить память для завершения операции.
E_INVALIDARG
 Предпринята попытка установить режим распознавания (свободный, настрочный, упакованный и т. д.), который не поддерживается распознавателем, или RECO_GUIDE значения полей недопустимы (например, отрицательная высота или ширина).
E_FAIL
 Произошла неизвестная ошибка.
TPC_E_OUT_OF_ORDER_CALL
 Попытка задать направляющую, когда в контексте reco уже есть рукописные фрагменты, или, в случае распознавателей восточноазиатских символов, SetCACMode был вызван ранее.

Комментарии

Направляющие нумеруются на основе значения iIntex .

Требования

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

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

Функция GetGuide

Структура RECO_GUIDE