InkAnalyzer.BackgroundAnalyze 方法

  • 项目

执行异步墨迹分析，这包括布局分析、书写和绘制分类以及手写识别。

命名空间：  System.Windows.Ink
程序集：  IAWinFX（在 IAWinFX.dll 中）

语法

声明
Public Function BackgroundAnalyze As Boolean
用法
Dim instance As InkAnalyzer
Dim returnValue As Boolean

returnValue = instance.BackgroundAnalyze()

public bool BackgroundAnalyze()

public:
bool BackgroundAnalyze()

public boolean BackgroundAnalyze()

public function BackgroundAnalyze() : boolean

返回值

类型：System.Boolean
如果已启动异步墨迹分析，则为 true；否则为 false。

备注

调用此方法时，InkAnalyzer 在后台线程上执行墨迹分析。InkAnalyzer 在用于创建 SynchronizingObject 的同一线程上引发墨迹分析所生成的事件。如果 InkAnalyzer.SynchronizingObject 属性为 nullnull 引用（在 Visual Basic 中为 Nothing），InkAnalyzer 还在一个后台线程上引发这些事件。

SynchronizingObject 属性控制 InkAnalyzer 在哪个线程上引发在后台分析过程中所生成的事件。

在以下情况下，此方法不启动新的后台分析操作。

  • 墨迹分析器当前正在执行后台分析。

  • DirtyRegion 表示空区域。

InkAnalyzer 即使在调用 Analyze 或 BackgroundAnalyze 期间对其 DirtyRegion 中的墨迹进行分析，也可以将分析操作扩展为包含邻近的区域。

此方法将 DirtyRegion 属性设置为空区域。

如果已在调用 BackgroundAnalyze 之后将笔画数据添加到墨迹分析器，则墨迹分析器可在墨迹分析的协调阶段更新 DirtyRegion 属性。

AnalysisModes 属性的值指定墨迹分析器执行其后台分析的方式。有关墨迹分析的更多信息，请参见Ink Analysis Overview。

此方法在以下情况下将引发异常。

  • 应用程序清除了 AnalysisModes 属性中的 [F:System.Windows.Ink. AnalysisModes.AutomaticReconciliationEnabled] 标志，且尚未添加 ReadyToReconcile 事件的事件处理程序。

  • 应用程序尚未添加 IntermediateResultsUpdated 事件或 Results() 事件的事件处理程序。

示例

此示例在墨迹分析器当前未执行墨迹分析的情况下，在名为 theInkAnalyzer 的 InkAnalyzer 上启动后台墨迹分析。

If Not theInkAnalyzer.IsAnalyzing Then
    Dim started As Boolean = theInkAnalyzer.BackgroundAnalyze()
End If

if (!theInkAnalyzer.IsAnalyzing)
{
    bool started = theInkAnalyzer.BackgroundAnalyze();
}

平台

Windows Vista

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

版本信息

.NET Framework

受以下版本支持：3.0

另请参见

参考

InkAnalyzer 类

InkAnalyzer 成员

System.Windows.Ink 命名空间

InkAnalyzerBaseAnalysisModes()

InkAnalyzerBaseDirtyRegion()

InkAnalyzerBaseRootNode()

InkAnalyzerBaseAnalyze()