iInkStrokeDisp::GetPacketData 方法 (msinkaut.h)

检索 IInkStrokeDisp 对象中数据包范围的数据包数据。

语法

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

参数

[in, optional] Index

可选。 从零开始的索引到笔划内数据包的起点。 在 InkSelectionConstants 枚举类型中定义的默认值ISC_FirstElement指定第一个数据包。

[in, optional] Count

可选。 应返回的点数据包数据集数,从 startingIndex 参数中指定的数据包开始。 在 InkSelectionConstants 枚举类型中定义的默认值ISC_AllElements指定构成笔划数据的所有点。

[out, retval] PacketData

此方法返回时,包含一个带符号的 32 位整数数组,其中包含笔划中请求的点的数据包数据。 数组包含第一个点的数据,然后包含第二个点的数据,等等。

有关 VARIANT 结构的详细信息,请参阅 使用 COM 库

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
成功。
E_POINTER
参数包含无效指针。
E_FAIL
发生了未指定的错误。
E_OUTOFMEMORY
无法分配 Stroke 处理程序帮助程序对象。
E_INVALIDARG
笔划无效。
E_INK_EXCEPTION
方法内发生异常。
E_UNEXPECTED
意外的参数或属性类型。

注解

如果笔划中的数据包数小于 startingIndexpointCount 参数的总和,则返回的数据数组包含的数据包信息比请求的计数少。

若要检索数据包数据的说明,请使用笔划的 PacketDescription 属性。 此属性返回一个全局唯一标识符数组 (GUID) ,该数组指示 GetPacketData 方法为每个点返回哪些属性值。 PacketProperty 常量包含可用的数据包属性 GUID。

要求

要求
最低受支持的客户端 Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 msinkaut.h
Library InkObj.dll

另请参阅

GetPacketDescriptionPropertyMetrics 方法

GetPacketValuesByProperty 方法

IInkStrokeDisp 接口

ItemSelectionConstants 枚举

PacketCount 属性

PacketDescription 属性

PacketSize 属性

SetPacketValuesByProperty 方法