Метод IInkStrokeDisp::GetPacketValuesByProperty (msinkaut.h)

Статья
08/25/2023

Извлекает данные для известного свойства пакета из одного или нескольких пакетов в росчерке.

Синтаксис

HRESULT GetPacketValuesByProperty(
  [in]           BSTR    PropertyName,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketValues
);

Параметры

[in] PropertyName

Идентификатор из констант PacketProperty , который использовался для выбора извлекаемого пакета.

Дополнительные сведения о типе данных BSTR см. в разделе Использование библиотеки COM.

[in, optional] Index

Необязательный элемент. Начальная точка отсчитываемого от нуля индекса для пакета в росчерке. Значение по умолчанию ISC_FirstElement, определенное в типе перечисления InkSelectionConstants , указывает первый пакет.

[in, optional] Count

Необязательный элемент. Количество точек, составляющих данные росчерка. Значение по умолчанию ISC_AllElements, определенное в типе перечисления InkSelectionConstants , задает все точки, составляющие данные росчерка.

[out, retval] PacketValues

При возврате этого метода содержит массив 32-разрядных целых чисел со знаком, указывающий значение запрошенного свойства PacketProperty для каждой точки, запрошенной из росчерка.

Дополнительные сведения о структуре VARIANT см. в разделе Использование библиотеки COM.

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

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

Код возврата	Описание
S_OK	Успешно.
TPC_E_INVALID_STROKE	Недопустимый штрих.
E_POINTER	Параметр содержал недопустимый указатель.
E_FAIL	Произошла неизвестная ошибка.
E_OUTOFMEMORY	Не удается выделить массив данных пакета.
E_INVALIDARG	Недопустимое свойство index, count или packet.
E_INK_EXCEPTION	В методе произошло исключение.
CO_E_CLASSSTRING	Недопустимый формат GUID.

Определенное свойство пакета может быть недоступно для определенного объекта IInkStrokeDisp . На планшетном компьютере может быть несколько планшетов для ввода данных пользователем. Коллекция InkTablets содержит список всех планшетов, подключенных к планшетному компьютеру. Используйте метод IsPacketPropertySupported , чтобы определить, поддерживается ли определенное свойство пакета определенным объектом IInkTablet или всеми доступными планшетами. Кроме того, используйте свойство DesiredPacketDescriptionсборщика рукописного ввода, чтобы управлять тем, какие свойства пакетов собираются при новых штрихах.

Требования

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