IInkAnalyzer::GetDirtyRegion 方法
擷取自上次分析作業後已變更的區域。
語法
HRESULT GetDirtyRegion(
[out] IAnalysisRegion **ppDirtyRegion
);
參數
-
ppDirtyRegion [out]
-
IAnalysisRegion,描述自上次分析作業以來已變更的區域。
傳回值
如需傳回值的描述,請參閱 類別和介面 - 筆跡分析。
備註
警告
若要避免記憶體流失,當您不再需要使用 物件時,請在ppDirtyRegion上呼叫IUnknown::Release。
這個方法會識別需要分析或重新分析的區域。 新增、更新或移除筆劃資料的所有 IInkAnalyzer 方法都會更新中途區域。 若要手動標示區域以進行重新分析:
- 使用 IInkAnalyzer::GetDirtyRegion 方法取得中途區域。
- 使用 IAnalysisRegion::UnionRegion 方法 或 IAnalysisRegion::UnionRectangle 方法 ,將區域新增至步驟 1 中的區域。
- 使用 IInkAnalyzer::SetDirtyRegion 方法來 更新中途區域。
IInkAnalyzer會在呼叫IInkAnalyzer::Analyze 方法或 IInkAnalyzer::BackgroundAnalyze 方法期間,分析其中途區域內的筆跡。 不過, IInkAnalyzer 可能會擴充分析作業,以包含鄰近區域。
此屬性可能包含非相鄰區域。
當您完成記憶體時,請使用 CoTaskMemFree 從 ppDirtyRegion 陣列釋放記憶體。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows XP Tablet PC Edition [僅限傳統型應用程式] |
最低支援的伺服器 |
都不支援 |
標頭 |
|
DLL |
|