共用方式為


IInkAnalyzer::Abort 方法

取消目前的分析作業。

語法

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

參數

ppAbortedRegion [out]

代表目前分析作業之 IAnalysisRegion 的 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 方法

筆跡分析參考