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

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

[in, optional] Count

可选。构成笔划数据的点数。在 InkSelectionConstants 枚举类型中定义的默认值 ISC_AllElements 指定构成笔划数据的所有点。

[out, retval] PacketValues

此方法返回时，包含一个 32 位有符号整数数组，该数组指定从笔划请求的每个点请求的 PacketProperty 的值。

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

返回值

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

返回代码	说明
S_OK	成功。
TPC_E_INVALID_STROKE	笔划无效。
E_POINTER	参数包含无效的指针。
E_FAIL	发生了未指定的错误。
E_OUTOFMEMORY	无法分配数据包数据数组。
E_INVALIDARG	索引、计数或数据包属性无效。
E_INK_EXCEPTION	方法内发生异常。
CO_E_CLASSSTRING	GUID 格式无效。

注解

特定数据包属性在特定 IInkStrokeDisp 对象上可能不可用。一台平板电脑可以有多个平板电脑供用户输入。 InkTablets 集合包含连接到平板电脑的所有平板电脑的列表。使用 IsPacketPropertySupported 方法可确定特定 IInkTablet 对象或所有可用平板电脑是否支持特定数据包属性。此外，使用墨迹收集器的DesiredPacketDescription 属性来控制在新笔划上收集哪些数据包属性。

要求

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