IInkAnalyzer::GetDirtyRegion メソッド

前回の分析操作以降に変更された領域を取得します。

構文

HRESULT GetDirtyRegion(
  [out] IAnalysisRegion **ppDirtyRegion
);

戻り値の説明については、「クラスとインターフェイス - インク分析」を参照してください。

注意事項

メモリリークを回避するには、オブジェクトを使用する必要がなくなったときに、ppDirtyRegion で IUnknown::Release を呼び出します。

このメソッドは、分析または再分析する必要がある領域を識別します。ストロークデータを追加、更新、または削除するすべての IInkAnalyzer メソッドは、ダーティ領域を更新します。再分析する領域を手動でマークするには:

IInkAnalyzer::GetDirtyRegion メソッドを使用して、ダーティリージョンを取得します。
手順 1 から領域をリージョンに追加するには、 IAnalysisRegion::UnionRegion メソッド または IAnalysisRegion::UnionRectangle メソッド を使用します。
IInkAnalyzer::SetDirtyRegion メソッドを使用して、ダーティリージョンを更新します。

IInkAnalyzer は、IInkAnalyzer::Analyze メソッドまたは IInkAnalyzer::BackgroundAnalyze メソッドの呼び出し中に、ダーティ領域内のインクを分析します。ただし、 IInkAnalyzer は、隣接する領域を含むように分析操作を拡張できます。

このプロパティには、隣接しない領域が含まれる場合があります。

完了したら、CoTaskMemFree を使用して ppDirtyRegion 配列からメモリを解放します。

要件	値
サポートされている最小のクライアント	Windows XP Tablet PC Edition [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
Header	IACom.h (IACom_i.c も必要)
[DLL]	IACom.dll