InkAnalyzer.Load 方法 (array<Byte[])

将保存的分析结果加载到墨迹分析器中。同时将墨迹数据加载到关联的 Microsoft.Ink.Ink 对象。

命名空间:  Microsoft.Ink
程序集:  Microsoft.Ink.Analysis(在 Microsoft.Ink.Analysis.dll 中)

语法

声明
Public Function Load ( _
    serializedResults As Byte() _
) As Boolean
用法
Dim instance As InkAnalyzer
Dim serializedResults As Byte()
Dim returnValue As Boolean

returnValue = instance.Load(serializedResults)
public bool Load(
    byte[] serializedResults
)
public:
bool Load(
    array<unsigned char>^ serializedResults
)
public boolean Load(
    byte[] serializedResults
)
public function Load(
    serializedResults : byte[]
) : boolean

参数

  • serializedResults
    类型:array<System.Byte[]
    一个包含保存的分析结果的 8 位无符号整数数组。

返回值

类型:System.Boolean
如果分析结果成功加载,则为 true;否则为 false。

备注

如果分析结果中包含墨迹数据,则 InkAnalyzer 将保存的笔画添加到与墨迹分析器关联的 Microsoft.Ink.Ink 对象。

InkAnalyzer 从保存的结果添加 ContextNode 时,会将新的全局唯一标识符 (GUID) 分配给 ContextNode 对象的 Id 属性。

此方法将保存的分析结果追加到现有结果中。若要确保对合并的结果正确进行排序,请将包含加载的上下文节点的区域添加到墨迹分析器的 DirtyRegion 并重新分析墨迹。

如果 InkAnalyzer 将保存的笔画添加到关联的 Microsoft.Ink.Ink 对象,则加载的分析结果将引用关联的墨迹中加载的笔画。

如果分析器没有将保存的笔画添加到关联的 Microsoft.Ink.Ink 对象,则分析器将比较保存的结果中的笔画标识符和现有 Microsoft.Ink.Ink 对象中的笔画标识符,从而将加载的分析结果与现有笔画关联起来。

如果保存的分析提示与现有分析提示冲突,则墨迹分析器不加载保存的提示,但加载保存的结果的其余部分。但是,如果保存的笔画数据位于未加载的保存的分析提示的区域内,则分析器将笔画的边界框添加到分析器的 DirtyRegion。同样,如果保存的笔画数据位于现有分析提示的区域内,分析器也会将笔画的边界框添加到分析器的 DirtyRegion。有关分析提示的更多信息,请参见 AnalysisHintNode

InkAnalyzer 在加载保存的结果时引发 ContextNodeCreatedContextNodeLinkAddingContextNodePropertiesUpdated 事件。

示例

此示例从 8 位无符号整数数组 theSavedResults 将保存的分析结果加载到 InkAnalyzer (theInkAnalyzer)。同时,此示例将保存的墨迹数据加载到分析器关联的 Microsoft.Ink.Ink 对象。

' Load previously saved analysis results and associated ink data.
successful = Me.theInkAnalyzer.Load(theSavedResults)
// Load previously saved analysis results and associated ink data.
successful = this.theInkAnalyzer.Load(theSavedResults);

平台

Windows Vista

.NET Framework 和 .NET Compact Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求

版本信息

.NET Framework

受以下版本支持:3.0

另请参见

参考

InkAnalyzer 类

InkAnalyzer 成员

Load 重载

Microsoft.Ink 命名空间

InkAnalyzer.Ink

InkAnalyzer.SaveResults

Microsoft.Ink.ContextNode

Microsoft.Ink.Ink

Microsoft.Ink.Stroke