IInkAnalyzer::SetStrokesType 方法
更改指定笔划的类型。
语法
HRESULT SetStrokesType(
[in] ULONG strokeIdCount,
[in] LONG *plStrokes,
[in] StrokeType StrokeType
);
parameters
-
strokeIdCount [in]
-
plStrokes 中的笔划标识符数。
-
plStrokes [in]
-
一个数组,包含要为其分配 StrokeType 的笔划的笔划标识符。
-
StrokeType [in]
-
要分配给笔划的 StrokeType 值。
返回值
有关返回值的说明,请参阅 类和接口 - 墨迹分析。
备注
如果笔划的类型是 strokeType 值 StrokeType_Unclassified, 则 IInkAnalyzer 在墨迹分析期间对笔划进行分类。 否则, IInkAnalyzer 将使用在笔划上设置的类型。
IInkAnalyzer 不会将笔划类型值设置为墨迹分析的一部分。 若要指定或更改笔划类型,请使用 IInkAnalyzer::SetStrokeType 方法 或 IInkAnalyzer::SetStrokesType 方法。
如果笔划与非未分类墨迹 节点的 IContextNode 关联 (请参阅 IContextNode::GetType) ,此方法会将笔划移动到包含相同语言笔划的未分类墨迹节点。 如果不存在此类上下文节点,此方法会创建一个新的未分类墨迹节点,并向其中添加笔划。 未分类墨迹节点是属于 UnclassifiedInk 类型的 IContextNode 。
如果此方法从非未分类墨迹节点的 IContextNode 移动笔划,此方法还会将笔划的边界框添加到墨迹分析器的脏区域, (请参阅 IInkAnalyzer::GetDirtyRegion 方法) 。
如果 StrokeType 参数与笔划的当前类型匹配,则此方法不会移动笔划。
如果在 strokeIds 中标识的笔划未与 IInkAnalyzer 关联,此方法将忽略标识符。
如果指定的笔划均未标识与 IInkAnalyzer 关联的笔划,则此方法返回而不更新 IInkAnalyzer。
在与已确认 NodeTypeAndProperties 的 ContextNode 关联的笔划上设置笔划类型将引发 InvalidOperationException。
当 plStrokes 为 NULL 时,此方法将返回错误代码。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP Tablet PC Edition [仅限桌面应用] |
最低受支持的服务器 |
无受支持的版本 |
标头 |
|
DLL |
|