IAnalysisRegion：：GetRegionScans 方法
检索定义 IAnalysisRegion 区域的矩形数组。
语法
HRESULT GetRegionScans(
[out] ULONG *pulCount,
[out] RECT **pRegionScans
);
参数
-
pulCount [out]
-
pRegionScans 中返回的矩形数。
-
pRegionScans [out]
-
指向定义 IAnalysisRegion 区域的矩形数组的指针。
返回值
有关返回值的说明，请参阅 类和接口 - 墨迹分析。
备注
如果 pRegionScans 作为 NULL 传递， 则 GetRegionScans 方法将返回 S_OK ，并在 pulCount 中返回矩形数。
注意
若要避免内存泄漏，请在不再需要信息时使用 CoTaskMemFree 从 *pRegionScans 释放内存。
矩形的边界采用墨迹空间坐标。
返回的矩形的并集表示 IAnalysisRegion 的区域。
示例
以下示例演示如何获取定义 IAnalysisRegion 区域的矩形， region 以及如何仅获取矩形数。
// Get the count and the rectangles.
ULONG count = 0;
RECT* rects = 0;
region->GetRegionScans(&count, &rects);
// Use rects
::CoTaskMemFree(rects);
// GetRegionScans just gets the count and returns S_OK
ULONG number = 0;
region->GetRegionScans(&number, NULL);
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 |
Windows XP Tablet PC Edition [仅限桌面应用] |
| 最低受支持的服务器 |
无受支持的版本 |
| 标头 |
|
| DLL |
|