共用方式為


IInkAnalyzer::Abort 方法

取消目前的分析作業。

語法

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

參數

ppAbortedRegion [out]

代表中途區域的 IAnalysisRegion 指標, (請參閱目前分析作業的 IInkAnalyzer::GetDirtyRegion 方法) 。

傳回值

如需傳回值的描述,請參閱 類別和介面 - 筆跡分析

備註

當您不再需要使用 物件時,在ppAbortedRegion上呼叫IUnknown::Release

這個方法會取消目前的分析作業。

ppAbortedRegionNull時,此方法會正常執行中止,因為這表示呼叫端對傳回值沒有興趣。

IInkAnalyzer::Abort 方法 會將目前分析作業的 _IAnalysisEvents::Results_IAnalysisEvents::Activity 事件靜音。

IInkAnalyzer::Abort 方法 會以非同步方式執行,直到取消目前的背景分析作業為止。 因為取消程式是非同步,所以當目前的分析作業取消時,應用程式可以執行其他工作。

如果沒有任何分析作業正在進行中,這個方法會傳回空的分析區域。

如果一個分析作業正在進行中,這個方法會取消作業。

如果同步和非同步分析作業正在進行中,這個方法會取消同步作業。

如果相同分析作業多次呼叫這個方法,則第一次呼叫會傳回作業的中途區域,而後續呼叫會傳回空區域。

如果您的應用程式維護與 IInkAnalyzer同步處理的資料結構,則呼叫 IInkAnalyzer::Abort 方法 可能會讓您的檔保留部分結果。 若要避免這種情況,請勿在IInkAnalyzer收到_IAnalysisProxyEvents::InkAnalyzerStateChanging事件,以及IInkAnalyzer收到_IAnalysisEvents::IntermediateResults_IAnalysisEvents::Results事件之間的IInkAnalyzer::Abort 方法

如需同步處理應用程式資料與筆跡分析器的詳細資訊,請參閱 使用筆跡分析的資料 Proxy

規格需求

需求
最低支援的用戶端
Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器
都不支援
標頭
IACom.h (也需要 IACom_i.c)
DLL
IACom.dll

另請參閱

IInkAnalyzer

IInkAnalyzer::Analyze 方法

IInkAnalyzer::BackgroundAnalyze 方法

IInkAnalyzer::GetDirtyRegion 方法

IInkAnalyzer::SetDirtyRegion 方法

筆跡分析參考