IInkAnalyzer：：GetDirtyRegion 方法

擷取自上次分析作業後已變更的區域。

語法

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

參數

ppDirtyRegion [out]

IAnalysisRegion，描述自上次分析作業以來已變更的區域。

傳回值

如需傳回值的描述，請參閱 類別和介面 - 筆跡分析。

備註

警告

若要避免記憶體流失，當您不再需要使用 物件時，請在ppDirtyRegion上呼叫IUnknown：：Release。

這個方法會識別需要分析或重新分析的區域。 新增、更新或移除筆劃資料的所有 IInkAnalyzer 方法都會更新中途區域。 若要手動標示區域以進行重新分析：

1. 使用 IInkAnalyzer：：GetDirtyRegion 方法取得中途區域。
2. 使用 IAnalysisRegion：：UnionRegion 方法 或 IAnalysisRegion：：UnionRectangle 方法 ，將區域新增至步驟 1 中的區域。
3. 使用 IInkAnalyzer：：SetDirtyRegion 方法來 更新中途區域。

IInkAnalyzer會在呼叫IInkAnalyzer：：Analyze 方法或 IInkAnalyzer：：BackgroundAnalyze 方法期間，分析其中途區域內的筆跡。 不過， IInkAnalyzer 可能會擴充分析作業，以包含鄰近區域。

此屬性可能包含非相鄰區域。

當您完成記憶體時，請使用 CoTaskMemFree 從 ppDirtyRegion 陣列釋放記憶體。

規格需求

需求	值
最低支援的用戶端	Windows XP Tablet PC Edition [僅限傳統型應用程式]
最低支援的伺服器	都不支援
標頭	IACom.h (也需要 IACom_i.c)
DLL	IACom.dll

另請參閱

IInkAnalyzer

IInkAnalyzer：：Analyze 方法

IInkAnalyzer：：BackgroundAnalyze 方法

IInkAnalyzer：：AddStroke 方法

IInkAnalyzer：：AddStrokeForLanguage 方法

IInkAnalyzer：：AddStrokes 方法

IInkAnalyzer：：AddStrokesForLanguage 方法

IInkAnalyzer：：RemoveStroke 方法

IInkAnalyzer：：RemoveStrokes 方法

IInkAnalyzer：：UpdateStrokesData 方法

筆跡分析參考