IInkAnalyzer::LoadResults 方法
将保存的分析结果加载到 IInkAnalyzer 中。
语法
HRESULT LoadResults(
[in] ULONG ulDataSize,
[in] BYTE *pbSerializedResults,
[in] ULONG ulStrokeIdsCount,
[in] LONG *plOriginalStrokeIds,
[in] LONG *plNewStrokeIds,
[out, retval] VARIANT_BOOL *pfSuccessful
);
parameters
-
ulDataSize [in]
-
pbSerializedResults 中的字节数。
-
pbSerializedResults [in]
-
序列化分析结果。
-
ulStrokeIdsCount [in]
-
笔划标识符的数目。
-
plOriginalStrokeIds [in]
-
原始笔划标识符的数组。
-
plNewStrokeIds [in]
-
新笔划标识符的数组。
-
pfSuccessful [out, retval]
-
如果加载成功,VARIANT_TRUE;否则,VARIANT_FALSE。
返回值
有关返回值的说明,请参阅 类和接口 - 墨迹分析。
备注
当 IInkAnalyzer 从保存的结果中添加 IContextNode 时,它会将新的全局唯一标识符 (GUID) 分配给 IContextNode (请参阅 IContextNode::GetPropertyData 和 上下文节点属性) 。
此方法将保存的分析结果添加到现有的 IContextNode 树。 若要确保正确排序组合结果,请将包含已加载上下文节点的区域添加到 IInkAnalyzer 对象的脏区域 (请参阅 IInkAnalyzer::GetDirtyRegion 方法) 并重新分析墨迹。
IInkAnalyzer::SaveResults 方法、IInkAnalyzer::SaveResultsForNodes 方法和IInkAnalyzer::SaveResultsForStrokes 方法不保存数据包数据以及分析结果。
plOriginalStrokeIds 中的每个标识符都是保存的分析结果中笔划的笔划标识符。 plNewStrokeIds 中的每个标识符都是用于替换加载分析结果中原始标识符的新标识符。
如果保存的分析提示与现有分析提示冲突, IInkAnalyzer 不会加载保存的提示,而是加载已保存结果的其余部分。 但是,如果 IInkAnalyzer 加载位于已保存分析提示 IInkAnalyzer 不加载的区域内的笔划的结果,则 IInkAnalyzer 会将笔划的边界框添加到 IInkAnalyzer 对象的脏区域。 此外,如果 IInkAnalyzer 加载位于现有分析提示区域内的笔划的结果,则 IInkAnalyzer 还会将笔划的边界框添加到 IInkAnalyzer 对象的脏区域。 有关分析提示的详细信息,请参阅 分析提示属性。
此方法可能会在加载保存的结果时引发 _IAnalysisProxyEvents::ContextNodeCreated、 _IAnalysisProxyEvents::ContextNodeLinkAdding 和 _IAnalysisProxyEvents::ContextNodePropertiesUpdated 事件。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP Tablet PC Edition [仅限桌面应用] |
最低受支持的服务器 |
无受支持的版本 |
标头 |
|
DLL |
|