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

Статья
08/25/2023

Извлекает данные пакета для диапазона пакетов в объекте IInkStrokeDisp .

Синтаксис

HRESULT GetPacketData(
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  VARIANT *PacketData
);

Параметры

[in, optional] Index

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

[in, optional] Count

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

[out, retval] PacketData

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

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

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

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

Код возврата	Описание
S_OK	Успешно.
E_POINTER	Параметр содержит недопустимый указатель.
E_FAIL	Произошла неизвестная ошибка.
E_OUTOFMEMORY	Не удается выделить вспомогательный объект обработчика stroke.
E_INVALIDARG	Недопустимый росчерк.
E_INK_EXCEPTION	В методе произошло исключение.
E_UNEXPECTED	Непредвиденный параметр или тип свойства.

Если количество пакетов в росчерке меньше суммы параметров startingIndex и pointCount , то возвращаемый массив данных содержит сведения о пакете за меньшее количество точек, чем запрошено.

Чтобы получить описание данных пакета, используйте свойство PacketDescription штриха. Это свойство возвращает массив глобально уникального идентификатора (GUID), который указывает, какие значения свойств возвращаются методом GetPacketData для каждой точки. Константы PacketProperty содержат идентификаторы GUID доступных свойств пакета.

Требования

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