IInkAnalyzer::GetDirtyRegion 方法
检索自上次分析操作以来已更改的区域。
语法
HRESULT GetDirtyRegion(
[out] IAnalysisRegion **ppDirtyRegion
);
parameters
-
ppDirtyRegion [out]
-
一个 IAnalysisRegion,描述自上次分析操作以来已更改的区域。
返回值
有关返回值的说明,请参阅 类和接口 - 墨迹分析。
备注
注意
若要避免内存泄漏,请在不再需要使用 对象时调用 iUnknown::Release on ppDirtyRegion 。
此方法标识需要分析或重新分析的区域。 添加、更新或删除笔划数据的所有 IInkAnalyzer 方法都会更新脏区域。 手动标记区域以供重新分析:
- 使用 IInkAnalyzer::GetDirtyRegion 方法获取脏区域。
- 使用 IAnalysisRegion::UnionRegion 方法 或 IAnalysisRegion::UnionRectangle 方法 将区域添加到步骤 1 中的区域。
- 使用 IInkAnalyzer::SetDirtyRegion 方法更新脏区域。
在调用 IInkAnalyzer::Analyze 方法或 IInkAnalyzer::BackgroundAnalyze 方法期间,IInkAnalyzer 分析其脏区域中的墨迹。 但是, IInkAnalyzer 可能会扩展分析操作以包括邻近区域。
此属性可能包含不相邻的区域。
使用 CoTaskMemFree 从 ppDirtyRegion 数组释放内存。
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP Tablet PC Edition [仅限桌面应用] |
最低受支持的服务器 |
无受支持的版本 |
标头 |
|
DLL |
|