IInkAnalyzer::Abort 方法

取消当前分析操作。

语法

HRESULT Abort(
  [out] IAnalysisRegion **ppAbortedRegion
);

参数

ppAbortedRegion [out]

指向 IAnalysisRegion 的指针,该指针表示脏区域, (请参阅当前分析操作的 IInkAnalyzer::GetDirtyRegion 方法) 。

返回值

有关返回值的说明,请参阅 类和接口 - 墨迹分析

备注

如果不再需要使用 对象,请调用 iUnknown::Release on ppAbortedRegion

此方法取消当前分析操作。

ppAbortedRegionNULL 时,此方法将正常执行中止,因为这表示调用方对返回值不感兴趣。

IInkAnalyzer::Abort 方法 将当前分析操作的 _IAnalysisEvents::Results_IAnalysisEvents::Activity 事件静音。

IInkAnalyzer::Abort 方法 异步运行,直到取消当前后台分析操作。 由于取消过程是异步的,因此应用程序可以在取消当前分析操作时执行其他任务。

如果没有正在进行的分析操作,此方法将返回空的分析区域。

如果正在进行一个分析操作,此方法将取消该操作。

如果同步和异步分析操作都在进行中,此方法将取消同步操作。

如果针对同一分析操作多次调用此方法,则第一次调用将返回操作的脏区域,后续调用将返回一个空区域。

如果应用程序维护自己的数据结构,该结构与 IInkAnalyzer 的数据结构同步,则调用 IInkAnalyzer::Abort 方法 可能会使文档留下部分结果。 若要避免这种情况,请勿在 IInkAnalyzer 收到 _IAnalysisProxyEvents::InkAnalyzerStateChanging 事件与 IInkAnalyzer 收到 _IAnalysisEvents::IntermediateResults_IAnalysisEvents::Results 事件之间调用 IInkAnalyzer::Abort 方法。

有关将应用程序数据与墨迹分析器同步的详细信息,请参阅 使用墨迹分析的数据代理

要求

要求
最低受支持的客户端
Windows XP Tablet PC Edition [仅限桌面应用]
最低受支持的服务器
无受支持的版本
标头
IACom.h (还需要 IACom_i.c)
DLL
IACom.dll

另请参阅

IInkAnalyzer

IInkAnalyzer::Analyze 方法

IInkAnalyzer::BackgroundAnalyze 方法

IInkAnalyzer::GetDirtyRegion 方法

IInkAnalyzer::SetDirtyRegion 方法

墨迹分析参考