IInkAnalyzer::Abort 方法
取消当前分析操作。
语法
HRESULT Abort(
[out] IAnalysisRegion **ppAbortedRegion
);
参数
-
ppAbortedRegion [out]
-
指向 IAnalysisRegion 的指针,该指针表示脏区域, (请参阅当前分析操作的 IInkAnalyzer::GetDirtyRegion 方法) 。
返回值
有关返回值的说明,请参阅 类和接口 - 墨迹分析。
备注
如果不再需要使用 对象,请调用 iUnknown::Release on ppAbortedRegion 。
此方法取消当前分析操作。
当 ppAbortedRegion 为 NULL 时,此方法将正常执行中止,因为这表示调用方对返回值不感兴趣。
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 [仅限桌面应用] |
最低受支持的服务器 |
无受支持的版本 |
标头 |
|
DLL |
|