IInkAnalyzer::Abort メソッド
現在の分析操作を取り消します。
構文
HRESULT Abort(
[out] IAnalysisRegion **ppAbortedRegion
);
パラメーター
-
ppAbortedRegion [out]
-
現在の分析操作のダーティ領域 (IInkAnalyzer::GetDirtyRegion メソッドを参照) を表す IAnalysisRegion へのポインター。
戻り値
戻り値の説明については、「 クラスとインターフェイス - インク分析」を参照してください。
解説
オブジェクトを使用する必要がなくなった場合は、ppAbortedRegion で IUnknown::Release を呼び出します。
このメソッドは、現在の分析操作を取り消します。
ppAbortedRegion が NULL の場合、呼び出し元が戻り値に関心がないことを示しているため、このメソッドは通常どおり中止を実行します。
IInkAnalyzer::Abort メソッド は、現在の分析操作の _IAnalysisEvents::Results イベントと _IAnalysisEvents::Activity イベントを無音にします。
IInkAnalyzer::Abort メソッド は、現在のバックグラウンド分析操作が取り消されるまで非同期的に実行されます。 取り消しプロセスは非同期であるため、現在の分析操作が取り消されている間、アプリケーションは他のタスクを実行できます。
進行中の分析操作がない場合、このメソッドは空の分析領域を返します。
1 つの分析操作が進行中の場合、このメソッドは操作を取り消します。
同期と非同期の両方の分析操作が進行中の場合、このメソッドは同期操作を取り消します。
同じ分析操作に対してこのメソッドが複数回呼び出された場合、最初の呼び出しは操作のダーティ領域を返し、後続の呼び出しは空の領域を返します。
アプリケーションが IInkAnalyzer のデータ構造と同期する独自のデータ構造を維持している場合、 IInkAnalyzer::Abort メソッド を呼び出すと、部分的な結果でドキュメントを残すことができます。 これを回避するには、IInkAnalyzer が_IAnalysisProxyEvents::InkAnalyzerStateChanging イベントを受信してから、IInkAnalyzer が _IAnalysisEvents::IntermediateResults または _IAnalysisEvents::Results イベントを受信するまでの間は、IInkAnalyzer::Abort メソッドを呼び出さないでください。
アプリケーション データをインク アナライザーと同期する方法の詳細については、「Data Proxy with Ink Analysis」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP Tablet PC Edition [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
サポートなし |
| ヘッダー |
|
| [DLL] |
|