Share via

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 方法

筆跡分析參考