iInkStrokeDisp::SetPacketValuesByProperty 方法 (msinkaut.h)

修改特定属性的数据包值。

语法

HRESULT SetPacketValuesByProperty(
  [in]           BSTR    bstrPropertyName,
  [in]           VARIANT PacketValues,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  long    *NumberOfPacketsSet
);

参数

[in] bstrPropertyName

全局唯一标识符 (GUID) 标识符,该标识符来自用于选择设置的数据包数据的 PacketProperty 常量。 使用 PacketDescription 确定此笔划的定义属性。

[in] PacketValues

数据包数据值的数组。 如果数组中的任何值超出属性的最小值或最大值,则方法失败。 若要确定 属性中的值范围,请调用 GetPacketDescriptionPropertyMetrics 方法。

[in, optional] Index

可选。 要修改的数据包的起始索引。 在 ItemSelectionConstants 枚举类型中定义的默认值ISC_FirstElement指定第一个数据包。

[in, optional] Count

可选。 指定要修改的笔划中的数据包数和 PacketValues 中的值数。 在 ItemSelectionConstants 枚举类型中定义的默认值ISC_AllElements指定修改所有数据包。

[out, retval] NumberOfPacketsSet

此方法返回时,包含设置的实际数据包数。

返回值

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

返回代码 说明
S_OK
成功。
E_POINTER
参数包含无效指针。
CO_E_CLASSSTRING
GUID 格式无效。
E_INVALIDARG
变量无效、索引 () 范围外或属性 GUID。
E_INK_EXCEPTION
方法内发生异常。

要求

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

另请参阅

GetPacketDescriptionPropertyMetrics 方法

IInkStrokeDisp 接口

ItemSelectionConstants 枚举

PacketPropertyGuids 常量