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

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

  • Статья

Добавляет росчерк рукописного ввода в RecognizerContext.

Синтаксис

HRESULT AddStroke(
  HRECOCONTEXT             hrc,
  const PACKET_DESCRIPTION *pPacketDesc,
  ULONG                    cbPacket,
  const BYTE               *pPacket,
  const XFORM              *pXForm
);

Параметры

hrc

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

pPacketDesc

Описывает содержимое пакетов. Описание должно соответствовать содержимому пакетов в pPacket. Если значение РАВНО NULL, эта функция использует функцию GetPreferredPacketDescription .

cbPacket

Размер буфера pPacket в байтах.

pPacket

Массив пакетов, содержащих координаты пространства планшета.

pXForm

Описывает преобразование, которое можно применить к рукописным фрагментам, чтобы преобразовать его из пространства планшета в пространство рукописного ввода. Распознаватель может проигнорировать это преобразование и реализовать собственные алгоритмы поворота рукописного ввода. Эти распознавели по-прежнему должны возвращать свойства, вычисленные в данных решетки, относительно этого преобразования.

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

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

Код возврата Описание
S_OK
 Успешно.
E_POINTER
 Один из параметров является недопустимым указателем.
E_OUTOFMEMORY
 Не удалось выделить память для завершения операции.
TPC_E_INVALID_PACKET_DESCRIPTION
 Описание пакета не содержит сведений, необходимых для того, чтобы пакет считался допустимым. Например, он не включает свойство GUID_X или GUID_Y.
TPC_E_OUT_OF_ORDER_CALL
 Вызов метода был выполнен не по порядку.
E_FAIL
 Произошла неизвестная ошибка.
E_INVALIDARG
 Получен недопустимый аргумент.

Комментарии

Распознаватель должен возвращать такие свойства, как базовые координаты в пространстве рукописного ввода, а не координаты планшета.

Рекомендуется, чтобы распознаватель наложил ограничение на количество штрихов в контексте и (или) точек, разрешенных в данном росчерке. Ограничьте ввод до 1024 штрихов на контекст и 32767 точек на штрих.

Штрихи с нулевыми точками не допускаются. В этом случае необходимо вернуть E_FAIL.

Требования

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

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

GetPreferredPacketDescription

Структура PACKET_DESCRIPTION