取消目前的分析作業。
語法
HRESULT Abort(
[out] IAnalysisRegion **ppAbortedRegion
);
參數
-
ppAbortedRegion [out]
-
代表目前分析作業之 IAnalysisRegion 的 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 |
|