IInkAnalyzer::Abort 方法
取消目前的分析作業。
語法
HRESULT Abort(
[out] IAnalysisRegion **ppAbortedRegion
);
參數
-
ppAbortedRegion [out]
-
代表中途區域的 IAnalysisRegion 指標, (請參閱目前分析作業的 IInkAnalyzer::GetDirtyRegion 方法) 。
傳回值
如需傳回值的描述,請參閱 類別和介面 - 筆跡分析。
備註
當您不再需要使用 物件時,在ppAbortedRegion上呼叫IUnknown::Release。
這個方法會取消目前的分析作業。
當 ppAbortedRegion 為 Null時,此方法會正常執行中止,因為這表示呼叫端對傳回值沒有興趣。
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 [僅限傳統型應用程式] |
最低支援的伺服器 |
都不支援 |
標頭 |
|
DLL |
|