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 タブレット PC エディション [デスクトップ アプリのみ]
サポートされている最小のサーバー
 サポートなし
ヘッダー
IACom.h (IACom_i.c も必要)
[DLL]
IACom.dll

関連項目

IAnalysisRegion

IAnalysisRegion::GetBounds メソッド

インク分析リファレンス