通过

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 [仅限桌面应用]
最低受支持的服务器
 无受支持的版本
标头
IACom.h (还需要 IACom_i.c)
DLL
IACom.dll

另请参阅

IAnalysisRegion

IAnalysisRegion：：GetBounds 方法

墨迹分析参考