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
此方法返回时,包含设置的实际数据包数。
返回值
此方法可以返回其中一个值。
返回代码 | 说明 |
---|---|
|
成功。 |
|
参数包含无效指针。 |
|
无效 索引 () 或 点 参数范围外。 格式不正确。 |
|
方法内发生异常。 |
注解
此方法不会更改笔划中的点数。 若要更改笔划中的点数,必须创建新的笔划,或者必须拆分笔划。
此方法不提供截断笔划。 如果 points 数组包含的点比笔划少,则不会修改笔划中的其余点。
此方法不提供用于扩展笔划的功能。 如果 points 数组包含的点数多于笔划,则不使用额外的点。 如果计数超过数组中的点数,则仅修改数组中的点数。
若要在调用 SetPoints 后绘制笔划,请调用 InvalidateRect 函数。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP Tablet PC Edition [仅限桌面应用] |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | msinkaut.h |
Library | InkObj.dll |