iInkStrokeDisp::SetPoints 方法 (msinkaut.h)

使用 X、Y 值数组设置 IInkStrokeDisp 的点。

语法

HRESULT SetPoints(
  [in]           VARIANT Points,
  [in, optional] long    Index,
  [in, optional] long    Count,
  [out, retval]  long    *NumberOfPointsSet
);

参数

[in] Points

新点数组,用于替换从 索引开始的笔划中的点。 这是一个 VARIANT,其中包含一个 Long 数组,这些数组的点由 x0、y0、x1、y1、x2、y2 等形式的交替值表示。

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

[in, optional] Index

可选。 要修改的笔划中第一个点的从零开始的索引。 在 ItemSelectionConstants 枚举类型中定义的默认值 ISC_FirstElement 指定修改笔划中的第一个点。

[in, optional] Count

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

[out, retval] NumberOfPointsSet

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

返回值

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

返回代码 说明
S_OK
成功。
E_POINTER
参数包含无效指针。
E_INVALIDARG
无效 索引 () 或 参数范围外。 格式不正确。
E_INK_EXCEPTION
方法内发生异常。

注解

此方法不会更改笔划中的点数。 若要更改笔划中的点数,必须创建新的笔划,或者必须拆分笔划。

此方法不提供截断笔划。 如果 points 数组包含的点比笔划少,则不会修改笔划中的其余点。

此方法不提供用于扩展笔划的功能。 如果 points 数组包含的点数多于笔划,则不使用额外的点。 如果计数超过数组中的点数,则仅修改数组中的点数。

若要在调用 SetPoints 后绘制笔划,请调用 InvalidateRect 函数。

要求

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

另请参阅

IInkStrokeDisp 接口

ItemSelectionConstants 枚举