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

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

  • Статья

Не позволяет распознавательу обрабатывать рукописный ввод, так как росчерк был добавлен или удален.

Синтаксис

HRESULT AdviseInkChange(
  HRECOCONTEXT hrc,
  BOOL         bNewStroke
);

Параметры

hrc

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

bNewStroke

Значение TRUE при добавлении нового росчерка. Установите значение FALSE , если штрихи были стерты, разделены, объединены, извлечены или удалены из объекта Ink.

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

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

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

Комментарии

Функция AdviseInkChange сигнализирует о том, что будут выполняться дополнительные вызовы функции AddStroke . Это позволяет любому распознаванию, который уже выполняется, останавливаться в любой удобной точке. Завершение распознавания является одним из таких моментов, поэтому AdviseInkChange может безопасно ничего не делать.

Например, если у вас есть два потока, один поток может использовать AddStroke и Process с другими функциями для получения результатов. Другой поток может собирать рукописный ввод, повторять его и выполнять задачи очередей для первого потока. Второй поток вызывает Метод AdviseInkChange , чтобы уведомить распознавателя о предстоящих изменениях. Это позволяет первому потоку вернуться к вызывающей объекту раньше, чем без вызова AdviseInkChange. Затем первый поток может снова вызвать распознаватель с дополнительными рукописными фрагментами.

Если для параметра bNewStroke задано значение FALSE , так как росчерк был изменен или удален, необходимо также вызвать функцию ResetContext , а затем вызвать функцию AddStroke , чтобы добавить штрихи из объекта InkDisp в контекст распознавателя. Это делается автоматически при присоединении контекста распознавателя к объекту InkDisp .

Требования

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