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

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

  • Статья

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

Синтаксис

HRESULT GetPreferredPacketDescription(
  HRECOGNIZER        hrec,
  PACKET_DESCRIPTION *pPacketDescription
);

Параметры

hrec

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

pPacketDescription

Описывает содержимое пакетов, которые использует распознаватель. Дополнительные сведения см. в разделе структура PACKET_DESCRIPTION .

Чтобы получить описание пакета, инициализируйте его с нулями и вызовите функцию GetPreferredPacketDescription . Функция заполняет количество свойств и кнопок, которые используются для выделения места для элементов pPacketProperties и pguidButtons структуры PACKET_DESCRIPTION . Вызовите функцию еще раз, чтобы заполнить оставшееся описание пакета.

Элемент pguidButtons структуры PACKET_DESCRIPTION может быть равен нулю при возврате GetPreferredPacketDescription . Это означает, что пакеты не имеют данных кнопки, поэтому для этого элемента не выделены pguidButtons. В этом случае вызывающая функция должна оставить указатель NULL.

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

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

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

Комментарии

Как правило, распознавители используют свойства координат (x, y) и игнорируют остальные. Если вы сохраните рукописный ввод в файл для распознавания позже, используйте предпочтительное описание пакета, чтобы сохранить только те свойства, которые использует распознаватель.

Требования

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

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

Функция AddStroke

Структура PACKET_DESCRIPTION