IInkAnalyzer：：AddStrokesForLanguage 方法
将多个笔划的笔划数据添加到 IInkAnalyzer ，并将指定的区域性标识符分配给笔划。
语法
HRESULT AddStrokesForLanguage(
[in] ULONG ulStrokeIdsCount,
[in] LONG *plIdofStrokesToAdd,
[in] LONG lStrokesLCID,
[in] ULONG ulStrokePacketDescriptionCount,
[in] GUID *pStrokePacketDescriptionGuids,
[in] ULONG *pulPacketDataCountPerStroke,
[in] LONG *plStrokePacketData,
[out] IContextNode **ppContextNodeStrokeAddedTo
);
parameters
-
ulStrokeIdsCount [in]
-
要添加的笔划数。
-
plIdofStrokesToAdd [in]
-
包含笔划标识符的数组。
-
lStrokesLCID [in]
-
一个 值，该值表示要分配给笔划的区域性标识符。
-
ulStrokePacketDescriptionCount [in]
-
每个数据包中的属性数。
-
pStrokePacketDescriptionGuids [in]
-
包含数据包属性标识符的数组。
-
pulPacketDataCountPerStroke [in]
-
包含每个笔划中的数据包数的数组。
-
plStrokePacketData [in]
-
包含笔划的数据包数据的数组。
-
ppContextNodeStrokeAddedTo [out]
-
墨迹分析器向其添加笔划的 IContextNode 。
返回值
有关返回值的说明，请参阅 类和接口 - 墨迹分析。
备注
注意
若要避免内存泄漏，请在不再需要使用 对象时调用 iUnknown：：Release on ppContextNodeStrokeAddedTo 。
当 ppContextNodeStrokeAddedTo 为 NULL 时，表示调用方对方法的返回值不感兴趣。
IInkAnalyzer 将笔划添加到 UnclassifiedInk 类型的 IContextNode (请参阅上下文节点类型) 。 此节点位于根节点的子节点集合中， (请参阅 IInkAnalyzer：：GetRootNode 方法和IContextNode：：GetSubNodes 方法) 。
IInkAnalyzer 将 lStrokeLCID 区域性标识符分配给笔划，并将笔划添加到墨迹分析器的根节点下的第一个 UnclassifiedInk 上下文节点，其中包含具有相同区域性标识符的笔划。 如果墨迹分析器没有具有相同区域性标识符的节点，它会在其根节点下创建新的 UnclassifiedInk 上下文节点，并将笔划添加到新的 UnclassifiedInk 上下文节点。
plStrokePacketData 包含所有笔划的数据包数据。 pStrokePacketDescriptionGuids 包含全局唯一标识符 (GUID) ，用于描述每个笔划中每个点包含的数据包数据类型。 有关可用数据包属性的完整列表，请参阅 PacketPropertyGuids 常量。
注意
在对 IInkAnalyzer：：AddStrokes 方法的单个调用中，只能添加具有相同数据包说明的笔划。
此方法将脏区域扩展到该区域的当前值和添加的笔划的边界框的并集。
如果 IInkAnalyzer 已包含与要添加的笔划之一具有相同标识符的笔划，则 IInkAnalyzer 将返回E_INVALIDARG的 HRESULT。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows XP Tablet PC Edition [仅限桌面应用] |
| 最低受支持的服务器 |
无受支持的版本 |
| 标头 |
|
| DLL |
|